Download the PHP package fengz/kuaishou-miniapp-sdk without Composer
On this page you can find all versions of the php package fengz/kuaishou-miniapp-sdk. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Table of contents
Download fengz/kuaishou-miniapp-sdk
More information about fengz/kuaishou-miniapp-sdk
Files in fengz/kuaishou-miniapp-sdk
Download fengz/kuaishou-miniapp-sdk
More information about fengz/kuaishou-miniapp-sdk
Files in fengz/kuaishou-miniapp-sdk
Vendor fengz
Package kuaishou-miniapp-sdk
Short Description Kuaishou Mini Program (快手小程序) server SDK for Laravel.
License MIT
Package kuaishou-miniapp-sdk
Short Description Kuaishou Mini Program (快手小程序) server SDK for Laravel.
License MIT
Please rate this library. Is it a good library?
Informations about the package kuaishou-miniapp-sdk
Fengz 快手小程序 SDK
中文 | English
为 快手小程序(Kuaishou Mini Program) 平台打造的服务端 SDK,专为 Laravel 设计。
功能特性
- access_token 管理 —— 缓存 + 惰性刷新,48 小时有效期。与部分平台不同,快手重复获取新 token 不会让旧 token 立即失效,因此无需防踩踏锁。
- code2Session 登录 —— 用
ks.login下发的 js_code 换取session_key/open_id。 - 小程序二维码 —— 返回 base64 图片字符串(并提供解码后的二进制辅助方法),支持尺寸/颜色/logo 配置。
- 订阅消息 —— 向已订阅用户发送模板消息(平台限制 QPS 100)。
- Webhook 回调 —— 验证事件推送签名(
kwaisign头,全文 MD5 + app_secret),并按message_id原子去重(平台在未收到{"result": 1}前最多重推 16 次)。
环境要求
- PHP 8.5
- Laravel 13.x
安装
发布配置文件:
在 .env 中配置凭证:
使用
也可以通过全局辅助函数调用:
关于成功码
快手网关用 result 作为成功/失败标记,但成功值在各接口间并不统一:
| 接口 | 成功 result |
|---|---|
| getAccessToken、code2Session、sendMessage | 1 |
| generateMpQrCode | 0 |
HTTP 客户端支持按调用传入成功码(默认 1),二维码管理器内部已显式传 0。你无需关心这个差异——每个管理器都会走正确的值。
错误处理
SDK 抛出的所有异常都继承 Fengz\KuaishouMiniapp\Exceptions\KuaishouMiniappException,按子类捕获可做精细控制:
token 失效类错误(result == 100200102,"access_token 授权错误")会在自动刷新 token 后重试一次。
未覆盖的能力
以下能力不在本 SDK 范围内,以及原因:
- epay(担保支付) —— 有自己的一套请求签名体系(排序参数 + secret,与 webhook 全文 MD5 不同),外加预支付/退款/查询/回调等接口。契约较复杂,值得单独立项;待各接口逐一核实后在后续版本加入。
- 垂类行业 API(电商/直播等)—— 行业专用,超出通用小程序 SDK 的范围。
测试
许可证
MIT —— 详见 LICENSE。
All versions of kuaishou-miniapp-sdk with dependencies
PHP Build Version
Package Version
Requires
php Version
^8.5
illuminate/contracts Version ^13.0
illuminate/http Version ^13.0
illuminate/support Version ^13.0
ext-json Version *
ext-mbstring Version *
illuminate/contracts Version ^13.0
illuminate/http Version ^13.0
illuminate/support Version ^13.0
ext-json Version *
ext-mbstring Version *
The package fengz/kuaishou-miniapp-sdk contains the following files
Loading the files please wait ...