如何在本地环境安全测试 DeepL API（解决 SSL 证书验证失败问题）-php教程-PHP中文网

如何在本地环境安全测试 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 环境选择其一）：

SSL

配置HTTPS，管理TLS证书，并调试安全连接问题。

下载

; 推荐方式：全局生效（影响所有 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 证书：

<?php require __DIR__ . '/vendor/autoload.php';
use DeepLDeepLException;
use DeepLTranslator;

try {
    $authKey = 'your-auth-key-here'; // 替换为真实密钥（测试可用免费 tier）
    $translator = new Translator($authKey);
    $result = $translator->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 解析正常。