Symfony2怎么封装百度API服务类？代码复用技巧-php教程-PHP中文网

应升级至symfony 6+并用httpclient封装百度api，因symfony 2已停更、不支持oauth 2.0/ak-sk签名，手写curl或guzzle易出错且难维护，需严格按百度规范生成签名并校验error_code而非http状态码。

symfony2怎么封装百度api服务类？代码复用技巧

Symfony 2 不再受官方支持，也不兼容现代百度 API 的认证方式（如 OAuth 2.0、AK/SK 签名机制），直接封装风险高、维护难。建议升级到 Symfony 6+ 并用 HttpClient 封装，否则你会反复踩签名失效、时钟偏移、cURL 版本不兼容、JSON 解析裸奔等坑。

为什么不用 cURL 或 Guzzle 手写百度 API 调用

百度多数开放服务（如翻译、OCR、地址解析）要求请求头带 Authorization 签名，且签名含时间戳、随机串、SHA256-HMAC 算法——手写极易出错；GuzzleHttp\Client 在 Symfony 2 中需手动管理生命周期和异常，而原生 cURL 更没法自动重试或解压 gzip。Symfony 2 自带的 sfWebBrowser 已废弃，无超时控制、无 JSON 自动解析、无异常分类。

百度翻译 API 返回 Content-Type: application/json;charset=UTF-8，但错误时返回 HTML 页面（如 401 页面），json_decode(file_get_contents(...)) 会静默失败或返回 null
签名计算必须严格按百度文档拼接参数、排序、urlencode，漏一个空格或大小写就 error_code: 110（签名错误）
Symfony 2 的依赖注入容器不支持构造器自动注入 HttpClient，你得在服务定义里硬写 new \Buzz\Browser()，后续没法 mock 测试

如果非要在 Symfony 2 中调用，至少把签名逻辑抽成独立类

别把 AK/SK、签名生成、HTTP 发送全塞进一个方法。拆三块：凭证管理、签名器、客户端适配器。这样未来换百度 SDK 或迁移到 Symfony 6 时，只换最后一层。

百度一镜

百度一镜是百度电商数字人直播平台，可用于数字人直播间创建、互动配置、直播脚本和AI工具使用。

下载

签名器类（如 BaiduSigner）只负责 generateAuthHeader($ak, $sk, $method, $uri, $params)，返回完整 Authorization 字符串
凭证存在 parameters.yml 里，用 %baidu.ak% 和 %baidu.sk% 注入，别硬编码
HTTP 层用 Buzz\Browser（Symfony 2 默认集成），设置 setOption('timeout', 10)，并检查 $response->getHeaders()['content-type'][0] 是否含 json 再决定是否 json_decode
所有百度响应先过 if (!isset($data['error_code']) || $data['error_code'] !== 0)，别信 getStatusCode() === 200 —— 百度 HTTP 状态码永远是 200，错误全靠 error_code 字段

Symfony 6+ 推荐封装方式（可直接复用）

哪怕你现在卡在 Symfony 2，也该按这个结构设计——迁移时只需改服务定义和构造器注入方式，业务逻辑几乎不动：

定义接口 BaiduApiClientInterface，声明 translate(string $q, string $from, string $to): array
实现类 BaiduApiClient 构造器接收 HttpClientInterface $client 和 string $ak、string $sk
关键方法里用 $this->client->request('POST', 'https://aip.baidubce.com/rest/2.0/xxx', [...])，然后直接调 $response->toArray()
签名逻辑仍保留在私有方法 private function buildAuthOptions(): array，返回 ['headers' => ['Authorization' => $auth]]，再传给 $client->withOptions(...)
错误统一捕获 ClientExceptionInterface 和 ServerExceptionInterface，再根据 $e->getResponse()->toArray()['error_code'] ?? null 做分支处理