PHPackages                             whalesky-labs/kwaishop-php-sdk - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. whalesky-labs/kwaishop-php-sdk

ActiveLibrary[API Development](/categories/api)

whalesky-labs/kwaishop-php-sdk
==============================

PHP SDK for Kuaishou E-commerce Open Platform.

v1.0.0(3mo ago)20MITPHPPHP ^8.1CI passing

Since Apr 19Pushed 3mo agoCompare

[ Source](https://github.com/whalesky-labs/kwaishop-php-sdk)[ Packagist](https://packagist.org/packages/whalesky-labs/kwaishop-php-sdk)[ Docs](https://github.com/whalesky-labs/kwaishop-php-sdk)[ RSS](/packages/whalesky-labs-kwaishop-php-sdk/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (1)Dependencies (3)Versions (2)Used By (0)

 [![KwaiShopSDK](https://avatars.githubusercontent.com/u/277389313?s=200&v=4)](https://avatars.githubusercontent.com/u/277389313?s=200&v=4)

KwaiShopSDK
===========

[](#kwaishopsdk)

 快手电商开放平台 PHP SDK。

 PHP SDK · 快手电商开放平台 · Composer 包 · API 集成

 [![PHP Version](https://camo.githubusercontent.com/29147a418f0dc92a7f3491fdb743b59b5ec45ea5d36889b2a68a403f22a3ca08/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d253345253344382e312d3737374242343f6c6f676f3d706870)](composer.json) [![License](https://camo.githubusercontent.com/784362b26e4b3546254f1893e778ba64616e362bd6ac791991d2c9e880a3a64e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d677265656e2e737667)](LICENSE) [![Composer](https://camo.githubusercontent.com/f8a56d065600f8df443c43ccece639b810d8e3deeef747a3f68d95499f1c3ce3/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f436f6d706f7365722d7768616c65736b792d2d6c6162732532466b77616973686f702d2d7068702d2d73646b2d3838353633303f6c6f676f3d636f6d706f736572)](https://packagist.org/packages/whalesky-labs/kwaishop-php-sdk)

 简体中文 | [English](README.en.md)

---

> 🚀 **快手电商 PHP SDK** - 为 PHP 开发者提供完整的快手电商 API 集成解决方案

概述
--

[](#概述)

在技术蓬勃发展的当下，快手电商开放平台的 KwaiShopSDK，本应是普惠所有开发者的得力工具，涵盖快手电商相关开放能力，从 Token 获取到请求封装、响应解释，每个环节都暗藏助力高效开发的玄机。

其本地化设计，理应为开发者开辟便捷通道，无论经验如何，都能借它在 API 调用之路上畅行无阻。可现实却令人咋舌，面对 PHP 这片高手云集、活力满满的领域，官方竟然缺失 PHP 版本的 SDK！

这简直荒谬至极。PHP 开发者们为互联网立下汗马功劳，如今却像被抛弃的孩子。看着其他语言开发者仗着官方 SDK 大步快跑，自己只能徒手在荆棘中挣扎，太不公平！好比马拉松赛场，别人装备精良、补给充足，自己却赤脚前行、无水可饮。

幸有补救性 SDK，让 PHP 开发者不至于掉队，能凭本事搭起投放管理系统，但背后是他们付出的诸多额外心血。官方这种"偏心"做法，实在该反省，给 PHP 开发者们一个交代！

功能特性
----

[](#功能特性)

- 支持 PHP `8.1+`
- 支持 `FPM`
- 支持 `Swoole Coroutine`
- 内置 `Guzzle` 传输实现
- 支持 `MD5` 与 `HMAC_SHA256` 签名
- 提供统一的 `Config` 配置对象
- 提供 OAuth 能力：授权地址生成、`code` 换取 token、刷新 token、`client_credentials`
- 提供统一请求工厂与响应解析器
- 提供按文档分类组织的接口实现目录：`src/Api/*`
- 提供标准请求基座：`get()`、`post()`、`postJson()`、`upload()`
- 提供 `rawRequest()` 作为网关兜底调用能力
- 提供 PHPUnit 测试底座与本地手动调试脚本

使用条件
----

[](#使用条件)

### 开发者条件

[](#开发者条件)

- 使用 SDK 需要首先注册成为快手电商开发者，请参考 [开发者快速入门文档](https://open.kwaixiaodian.com/zone/new/docs/dev)
- 使用 SDK 需要先拥有 API 的访问权限，所有 SDK 的使用与应用拥有的权限组相关联

SDK 目录
------

[](#sdk-目录)

```
src/
├── Api/                    # 按官方文档分类组织的接口封装
│   ├── Comment/            # 评价 API
│   ├── Cs/                 # 客服 / 会话 API
│   ├── Distribution/       # 分销 / 招商 / CPS API
│   ├── Dropshipping/       # 代打代发 API
│   ├── Express/            # 电子面单 / 打印 API
│   ├── Funds/              # 资金 / 对账 / 提现 API
│   ├── Industry/           # 行业能力 API
│   ├── Invoice/            # 发票 API
│   ├── Item/               # 商品 API
│   ├── Live/               # 直播场景 API
│   ├── Logistics/          # 地址 / 运费模板 / 物流 API
│   ├── Member/             # 会员 API
│   ├── MerchantMember/     # 商家会员 API
│   ├── Order/              # 订单 API
│   ├── Photo/              # 图文 / 图片素材 API
│   ├── Promotion/          # 营销 API
│   ├── Refund/             # 售后 / 退款 API
│   ├── Scm/                # 供应链 / 库存 / 仓储 API
│   ├── Security/           # 安全日志 / 解密 API
│   ├── ServiceMarket/      # 服务市场 API
│   ├── Shop/               # 店铺 API
│   ├── Sms/                # 短信 API
│   ├── Tool/               # 工具类开放能力 API
│   ├── User/               # 用户 / 商家信息 API
│   └── Virtual/            # 虚拟商品 API
├── Auth/                   # OAuth 鉴权与 Token 对象
├── Client/                 # SDK 主客户端、请求基座与请求流水线
│   └── Pipeline/           # 请求构建与响应解析流水线
├── Config/                 # 配置对象
├── Exception/              # SDK 异常体系
├── Generated/              # 自动生成的客户端方法映射
├── Runtime/                # FPM / CLI / Swoole 运行时识别
├── Signing/                # MD5 / HMAC_SHA256 签名实现
├── Support/                # 通用辅助工具
└── Transport/              # HTTP 传输抽象与 Guzzle 实现

```

说明：

- `Api/*` 目录按官方文档分类组织，方便快速定位对应接口
- `Client/*` 目录提供 SDK 入口、请求抽象与请求处理流水线
- `Generated/*` 目录用于承载自动生成的客户端方法映射
- `KwaiShopClient` 当前位于 `KwaiShopSDK\Client\KwaiShopClient`
- 如果你想查看某个接口是否已封装，优先到对应分类目录中检索

安装
--

[](#安装)

```
composer require whalesky-labs/kwaishop-php-sdk
```

快速开始
----

[](#快速开始)

```
