本地PHP测试DeepL API遇SSL自签名证书链问题求助

问题说明 #

DeepL\ConnectionException: SSL certificate problem: self signed certificate in certificate chain.

测试代码：

<?php
require __DIR__ . '/vendor/autoload.php';
use DeepL\DeepLException;
use DeepL\Translator;

try
{
    $authKey = "HIDDEN_KEY";
    $translator = new Translator($authKey);
    $result = $translator->translateText('Hello, world!', null, 'fr');
    echo $result->text; // Should print "Bonjour, le monde!"
} catch (DeepLException $e)
{
    echo "KO";
    error_log($e);
}

本地测试解决方案 #

方案1：临时关闭SSL验证（仅本地调试用，生产环境禁用） #

创建Translator实例时添加关闭SSL验证的配置：

$translator = new Translator($authKey, [
    'verify_ssl' => false,
]);

这个方法能快速绕开证书问题，但存在安全风险，仅限本地测试阶段使用。

方案2：配置合法CA证书 #

1. 下载标准根证书包（如Mozilla维护的CA证书集合），保存到本地路径，比如./cacert.pem
2. 在Translator配置中指定证书路径：

$translator = new Translator($authKey, [
    'verify_ssl' => __DIR__ . '/cacert.pem',
]);

或者修改本地PHP配置文件php.ini，设置全局CA证书路径：

curl.cainfo = "C:/your-path/cacert.pem" ; Windows环境示例
curl.cainfo = "/usr/local/etc/openssl/cacert.pem" ; Linux/macOS环境示例

修改后重启本地服务，既保证安全又能解决证书链问题。

方案3：排查本地代理/防火墙 #

如果本地使用了代理或防火墙，可能会拦截SSL请求并替换证书。暂时关闭代理或调整防火墙规则，再测试API连接是否恢复正常。

内容的提问来源于stack exchange，提问作者Abderrahim Benmelouka