标题: 如何使用 Composer 简化百度小程序开发：houyingcai/baidu-mini-sdk 的应用-composer-PHP中文网

标题: 如何使用 Composer 简化百度小程序开发：houyingcai/baidu-mini-sdk 的应用

WBOY

发布： 2025-03-15 12:36:37

原创

731人浏览过

可以通过一下地址学习composer：学习地址

文章内容

在开发百度智能小程序的过程中，我遇到了一个棘手的问题：百度官方尚未发布完整的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 BaiduMiniProgram\Services\BaiduTemplate;
use BaiduMiniProgram\Services\BaiduTemplateMessage;

$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 Http\Client\HttpClient
{
    public function sendRequest(Psr\Http\Message\RequestInterface $request) : Psr\Http\Message\ResponseInterface
    {
        // 实现发送请求逻辑
    }
}

$app = new BaiduClient('App Key', 'App Secret', new YourHttpClient());

登录后复制