PHPackages lyndon1994/xiongzhang-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. lyndon1994/xiongzhang-sdk ActiveLibrary[API Development](/categories/api) lyndon1994/xiongzhang-sdk ========================= 熊掌号 SDK 1.0.2(8y ago)2562MITPHPPHP >=5.6.0 Since Mar 18Pushed 8y ago3 watchersCompare [ Source](https://github.com/Lyndon1994/xiongzhang-sdk)[ Packagist](https://packagist.org/packages/lyndon1994/xiongzhang-sdk)[ RSS](/packages/lyndon1994-xiongzhang-sdk/feed)WikiDiscussions master Synced yesterday READMEChangelogDependencies (2)Versions (5)Used By (0) SDK概要 ----- [](#sdk概要) ### 目标：提供熊掌号开放平台的基本能力，提升熊掌号及TP的接入效率 [](#目标提供熊掌号开放平台的基本能力提升熊掌号及tp的接入效率) #### 本版本支持的功能 [](#本版本支持的功能) ##### \[针对熊掌号\] [](#针对熊掌号) - 熊掌号开放平台相关加减密算法 \[完毕\] - 消息加减密 aes封装 【支持】 - server校验 sha1封装 【支持】 - PUSH 熊掌号消息处理 \[完毕\] - 文本类型消息接收、发送 【支持】 - 图片类型消息接收、发送 【支持】 - 语音类型消息接收、发送 \[待开放功能\] - 事件类型消息接收、发送 【支持】 - 关注/取消关注 - 菜单点击/跳转 - PS:消息明文、密文格式都可用，兼容格式代调式 - PUSH 熊掌号支付消息处理 \[完毕\] - 支付事件消息接收、发送 【支持】 - 支付成功回调 - 退款成功回调 ##### \[针对TP\] [](#针对tp) - PUSH TP 消息处理 \[完毕\] - 接收熊掌号平台推送的 ticket 【支持】 - B2B授权-授权结果（授权、更新授权、取消授权）通知【支持】 - TP代开号-熊掌号审核结果通知 \[待开放功能\] - 接收已授权熊掌号的事件消息 \[待开发\] - PUSH 熊掌号消息处理 \[完毕\] - 文本类型消息接收、发送 【支持】 - 图片类型消息接收、发送 【支持】 - 语音类型消息接收、发送 \[待开放功能\] - 事件类型消息接收、发送 【支持】 - 关注/取消关注 - 菜单点击/跳转 安装 -- [](#安装) ``` composer require lyndon1994/xiongzhang-sdk ``` 使用 -- [](#使用) ### 示例 [](#示例) ``` /** * 开发者设置 */ $init = array( 'token' => 'TOKEN', 'encodingAesKey' => 'ENCODINGAESKEY', 'clientId' => 'CLIENTID', 'clientSecret' => 'CLIENTSECRET', 'packType' => 'json', 'log' => [ 'level' => 'debug', 'file' => 'xzh.log', ], ); $xzhLib = Server::init($init); $msgType = $xzhLib->getRevType(); $msgData = $xzhLib->getRevData(); $xzhLib::$log->notice("Rev msgType: {$msgType} msgData:" . json_encode($msgData)); // 根据消息类型，做业务响应 switch ($msgType) { case SdkConfig::MSGTYPE_TEXT: // 文本类型 $content 开发者根据$msgData自己组织回复 $xzhLib->text(SdkConfig::REV_TEXT_DEFAULT_REPLY)->reply(); break; case SdkConfig::MSGTYPE_EVENT: // 事件类型（如不需跟开发者交互，返回success即可） $event = $msgData['Event']; switch ($event) { case SdkConfig::EVENT_SUBSCRIBE: $xzhLib->text(SdkConfig::EVENT_SUBSCRIBE)->reply(); break; case SdkConfig::EVENT_UNSUBSCRIBE: $xzhLib->text(SdkConfig::EVENT_UNSUBSCRIBE)->reply(); break; case SdkConfig::EVENT_MENU_VIEW: $xzhLib->text(SdkConfig::EVENT_MENU_VIEW)->reply(); break; case SdkConfig::EVENT_MENU_CLICK: $xzhLib->text(SdkConfig::EVENT_MENU_CLICK)->reply(); break; default: // TODO 如有新增事件，在补充 $xzhLib->text(SdkConfig::REV_NOT_KNOW_MSGTYPE_REPLY)->reply(); } break; case SdkConfig::MSGTYPE_IMAGE: // 返回一张图片，注意回复的图片 mediaId 需要先上传 $xzhLib->image(691654)->reply(); break; case SdkConfig::MSGTYPE_VOICE: // $xzhLib->voice(691654)->reply(); $xzhLib->text('waiting!!!')->reply(); break; case SdkConfig::MSGTYPE_PAY: $payEvent = $msgData['Event']; switch ($payEvent) { case SdkConfig::EVENT_PAY_PAY: $xzhLib->pay(1)->reply(); break; case SdkConfig::EVENT_PAY_REFUND: $xzhLib->refund()->reply(); break; default: $xzhLib::$log->notice('pay event error; event:' . $payEvent); $xzhLib->text('')->reply(); } break; default: // TODO 如有新增消息类型，在补充 $xzhLib->text(SdkConfig::REV_SUCCESS_REPLY)->reply(); } ``` ### 框架支持 [](#框架支持) #### Laravel [](#laravel) ##### 配置 [](#配置) ###### Laravel 应用 [](#laravel-应用) 1. 注册 ServiceProvider: ``` Xiongzhang\Laravel\XiongzhangServiceProvider::class, ``` 2. ENV 中支持以下配置： ``` # client_id XZH_CLIENTID # client_secret XZH_CLIENTSECRET # token XZH_TOKEN # aes_key XZH_AES_KEY # 熊掌号消息格式类型，默认xml XZH_PACK_TYPE # 输出日志等级，默认debug XZH_LOG_LEVEL # 输出日志路径，默认/storage/logs/xzh.log XZH_LOG_FILE ``` ###### Lumen 应用 [](#lumen-应用) 1. 在 bootstrap/app.php 中 82 行左右： ``` $app->register(Xiongzhang\Laravel\XiongzhangServiceProvider::class); ``` 2. ENV 中支持以下配置：同Laravel应用 ##### 使用 [](#使用-1) 1. 获取服务实例： ``` $xzhLib = app('xiongzhang'); ``` 2. 接下来的使用如同上面的示例。 ### Health Score 28 — LowBetter than 54% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity13 Limited adoption so far Community7 Small or concentrated contributor base Maturity61 Established project with proven stability How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~0 days Total 3 Last Release 2977d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/454d8a6637ca7fafc972487ad69d1fe19277f78c056633898e934c4bc56145f2?d=identicon)[Lyndon](/maintainers/Lyndon) ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/lyndon1994-xiongzhang-sdk/health.svg) ``` [![Health](https://phpackages.com/badges/lyndon1994-xiongzhang-sdk/health.svg)](https://phpackages.com/packages/lyndon1994-xiongzhang-sdk) ``` ### Alternatives [googleads/googleads-php-lib Google Ad Manager SOAP API Client Library for PHP 67410.3M25](/packages/googleads-googleads-php-lib)[googleads/google-ads-php Google Ads API client for PHP 3497.6M9](/packages/googleads-google-ads-php)[team-reflex/discord-php An unofficial API to interact with the voice and text service Discord. 1.1k379.4k24](/packages/team-reflex-discord-php)[wheelpros/fitment-platform-api Magento 2 (Open Source) 12.1k1.2k](/packages/wheelpros-fitment-platform-api)[checkout/checkout-sdk-php Checkout.com SDK for PHP 553.3M7](/packages/checkout-checkout-sdk-php)[convertkit/convertkitapi Kit PHP SDK for the Kit API 2167.1k1](/packages/convertkit-convertkitapi) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)