文章内容
在开发百度智能小程序的过程中,我遇到了一个棘手的问题:百度官方尚未发布完整的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客户端,极大地提升了开发效率。如果你也在开发百度小程序,强烈推荐使用这个库来简化你的开发流程。