如何在本地环境安全测试 DeepL API（解决 SSL 证书验证失败问题）

本文聚焦于本地开发环境中调用 DeepL PHP SDK 时常见的 “SSL certificate problem: self signed certificate in certificate chain” 报错，系统拆解其底层成因，并给出更稳妥的专业处理方案，内容覆盖 CA 证书配置、PHP cURL 设置以及安全调试中的关键注意事项。

本文详解在本地开发环境中调用 DeepL PHP SDK 时出现 “SSL certificate problem: self signed certificate in certificate chain” 错误的根本原因与专业级解决方案，涵盖 CA 证书配置、PHP cURL 设置及安全调试建议。

DeepL 最新 PHP SDK 底层依赖 cURL 发起 HTTPS 请求，而该错误表明 PHP 的 cURL 扩展无法验证 DeepL API（https://api.deepl.com）的 TLS 证书链——常见于本地开发环境缺少或未正确配置可信根证书（CA bundle），尤其在 Windows XAMPP/MAMP、旧版 macOS 或自建 PHP 环境中高发。

✅ 正确解决方案：配置可信 CA 证书

不要禁用 SSL 验证（如 CURLOPT_SSL_VERIFYPEER => false） —— 这会暴露中间人攻击风险，违反安全最佳实践，且 DeepL 服务端强制要求有效 TLS 证书，临时绕过仅掩盖问题，不可用于任何生产或准生产场景。

步骤 1：获取最新 CA 根证书包

从 cURL 最新维护的 Mozilla CA Bundle 下载 cacert.pem 文件（推荐定期更新）。

步骤 2：配置 PHP 的 openssl.cafile 或 curl.cainfo

在 php.ini 中添加（根据你的 PHP 环境选择其一）：

; 推荐方式：全局生效（影响所有 HTTPS 请求）
openssl.cafile="/path/to/your/cacert.pem"
; 或针对 cURL 单独配置（更精准）
curl.cainfo="/path/to/your/cacert.pem"

⚠️ 注意路径格式：Windows 使用正斜杠 / 或双反斜杠 \，避免单反斜杠 ；确保路径为绝对路径，且文件具有读取权限。

步骤 3：重启 Web 服务器与 CLI 环境

• Apache/Nginx：重启服务
• CLI 测试：执行 php -i | grep -i "cafile|cainfo" 验证配置已加载
• 示例验证命令：

  php -r "print_r(openssl_get_cert_locations());"

步骤 4：验证 DeepL 调用（无需修改业务代码）

原代码完全保持不变，SDK 将自动使用系统配置的 CA 证书：

translateText('Hello, world!', null, 'fr');
echo $result->text; // 输出：Bonjour, le monde !
} catch (DeepLException $e) {
error_log('DeepL API Error: ' . $e->getMessage());
echo "Translation failed.";
}

? 补充排查技巧

• 若仍报错，检查是否多个 php.ini 文件被加载（通过 php --ini 查看实际加载路径）；
• 在 CLI 下运行 php -r "var_dump(file_get_contents('https://api.deepl.com/v2/languages?auth_key=test'));" 可快速验证基础 HTTPS 连通性；
• DeepL API 域名必须为 api.deepl.com（非 www.deepl.com），确保 DNS 解析正常。

✅ 总结

本地测试 DeepL API，关键从来不是“绕过 SSL”，而是把信任链补齐。CA 证书配置到位后，通信安全才能真正有保障，TLS 行为也会和生产环境保持一致，这样一来，“本地即线上”的开发体验才算真正落地。需要特别警惕的是，无论在哪种环境下，都不要关闭证书验证——这不仅碰了安全红线，也是 DeepL 服务端明确要求必须遵守的规则。