文章內容
在開發百度智能小程序的過程中，我遇到了一個棘手的問題：百度官方尚未發布完整的php SDK，僅有的百度收銀臺SDK也只支持生成和驗證簽名，無法滿足實際開發需求。面對這種情況，我嘗試了多種方法，最終找到了houyingcai/baidu-mini-sdk這個第三方庫，它完美地解決了我的問題。
houyingcai/baidu-mini-sdk是一個專為百度智能小程序開發的PHP SDK，支持PHP 5.4，并遵循PSR-7標準。它提供了登錄、解密、模板消息、支付等多項功能，極大地簡化了開發流程。以下是如何使用composer安裝和使用這個庫的詳細指南。
安裝
首先，通過Composer安裝houyingcai/baidu-mini-sdk：
composer require houyingcai/baidu-mini-sdk:dev-master
使用
安裝完成后，你可以按照以下步驟使用該庫：
1. 創建BaiduClient實例
use BaiduMiniProgram; $app = new BaiduClient('App Key', 'App Secret');
App Key和App Secret可以在百度小程序開發者后臺的“開發設置”中找到。BaiduClient實例通常在整個業務流程中使用，只需在初始化階段創建一次。
2. 登錄
百度小程序的登錄流程遵循OAuth 2.0標準，類似于微信小程序。通過swan.login獲取code，然后在服務端使用該code進行登錄：
$credential = $app->session($code);
成功后，$credential會返回包含openid和session_key的數組。
3. 解密
百度小程序提供的開放數據是加密的，可以通過以下代碼在服務端解密：
$decrypted = $app->decrypt($data, $iv, $credential['session_key']);
4. 模板消息
創建模板消息并發送給用戶：
use BaiduMiniProgramServicesBaiduTemplate; use BaiduMiniProgramServicesBaiduTemplateMessage; $serviceClient = $app->serviceClient(); $template = new BaiduTemplate($serviceClient); $data = (new BaiduTemplateMessage($templateId, $serviceClient)) ->withKeywords([ 'keyword1' => 'foo', 'keyword2' => 'bar', ]) ->sendTo('小程序用戶 Swan ID', 'Scene ID');
5. 支付
百度收銀臺是獨立的支付產品，需要單獨注冊并認證。使用以下命令生成密鑰：
bin/genrsa [密鑰生成目錄]
然后，使用以下命令轉換平臺公鑰：
bin/wrap-key <單行密鑰文本>
支付通知的處理如下：
$response = $payment->handleNotification( function ($parameters) { // 編寫業務邏輯 }, function (Exception $exception) { // 記錄異常 }, $_POST ); echo $response;
深入
houyingcai/baidu-mini-sdk遵循PSR-7標準，http客戶端基于HTTPlug，支持自定義HTTP客戶端。例如，使用Guzzle 6.x：
composer require guzzlehttp/guzzle:^6.0 composer require php-http/discovery composer require php-http/guzzle6-adapter
或者自定義HTTP客戶端：
class YourHttpClient implements HttpClientHttpClient { public function sendRequest(PsrHttpMessageRequestInterface $request) : PsrHttpMessageResponseInterface { // 實現發送請求邏輯 } } $app = new BaiduClient('App Key', 'App Secret', new YourHttpClient());
總結
通過使用houyingcai/baidu-mini-sdk，我成功解決了百度小程序開發中的多項難題。該庫不僅提供了豐富的功能，還支持自定義HTTP客戶端，極大地提升了開發效率。如果你也在開發百度小程序，強烈推薦使用這個庫來簡化你的開發流程。
