PHP cURL error 60 完全解决指南:self signed certificate 与 CA 证书链配置
PHP 里出现 cURL error 60: SSL certificate problem: self signed certificate,本质上只有一句话:cURL 在 TLS 握手阶段无法验证对端证书。它不是网络不通,也不是扩展没装,而是本机的 CA 信任链没有对上。本文给出三条可落地的修法(系统 CA 包、自签根证书、流包装器 / Guzzle / Composer),并附上排错时可以直接对照的真实报错。
一、错误现象:error 60 到底在报什么
60 是 libcurl 的错误码 CURLE_PEER_FAILED_VERIFICATION,含义是「对端证书校验失败」。冒号后面的 detail 才是真正的线索,不同 detail 对应完全不同的修法:
cURL error 60: SSL certificate problem: self signed certificate
cURL error 60: SSL certificate problem: unable to get local issuer certificate
cURL error 60: SSL certificate problem: self signed certificate in certificate chain
cURL error 60: SSL certificate problem: certificate has expired
cURL error 60: SSL: no alternative certificate subject name matches target host name
cURL error 77: error setting certificate verify locations:
CAfile: C:phpcacert.pem CApath: none
- self signed certificate:服务端用的就是自签证书,或者由内网 CA 签发但你没把它加进信任列表。
- unable to get local issuer certificate:本机没有可用的 CA 包(Windows PHP 的经典症状),或者服务端没发中间证书。
- self signed certificate in certificate chain:证书链中间夹了一个自签根,常见于内网反向代理 / 抓包工具(Charles、Fiddler、Zscaler)。
- certificate has expired:证书过期,跟 CA 配置无关,换证书即可。
- no alternative certificate subject name matches:主机名与 SAN 不匹配。现代 TLS 栈只看 SAN,不看 CN。
- error 77:CA 文件路径写错、文件不存在或没有读权限,属于配置错误而非证书错误。
二、三种根因,先用命令分清是哪一种
在改任何配置之前,先跑下面四条命令,能省掉一半瞎试的时间:
# 1. 看 PHP 当前生效的 CA 配置(Windows 用 findstr)
php -i | grep -i cainfo
php -i | findstr /i cainfo
# 2. 看 OpenSSL 默认会去哪些路径找 CA
php -r 'print_r(openssl_get_cert_locations());'
# 3. 确认改的是哪个 php.ini(CLI 与 FPM 常常不是同一个)
php --ini
# 4. 直接抓服务端证书链,看它到底发了什么
openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts </dev/null
根因 A:PHP 没有配置 CA 包(Windows 最常见)
Windows 版 PHP 的 zip 包里通常能在 extras/ssl/ 下找到 cacert.pem,但 php.ini 默认没有启用 curl.cainfo。于是 cURL 拿着一份空 CA 列表去验证公网证书,任何 HTTPS 请求都会失败。Linux 上如果是精简镜像(slim、alpine)且没装 ca-certificates,症状一模一样。
根因 B:目标站点使用自签证书或私有 CA
内网服务、测试环境、本地 *.local.test 域名经常用自签证书。这种情况下即使系统 CA 包装好了也没用——你的 CA 包里本来就不该有这个根证书,必须显式信任它。
根因 C:证书链不完整
服务端只下发了 leaf 证书,没有下发中间证书。浏览器会自动补链(AIA fetching),cURL 不会。用第 4 条命令可以看到返回的证书数量:正常应有 2 张以上,只有 1 张基本就是缺中间证书。这个问题的正确修法是让运维补全链,而不是在客户端关校验。
三、方案一:为 PHP 配置系统级 CA 包(首选)
适用于「访问公网 HTTPS 全部失败」的场景,一次配置,全站 cURL 与流包装器同时生效。
1. 下载并放置 CA 包
# Linux / macOS
sudo curl -o /etc/ssl/certs/cacert.pem https://curl.se/ca/cacert.pem
sudo chmod 644 /etc/ssl/certs/cacert.pem
# 或者直接用发行版维护的包(更省心,会随系统更新)
sudo apt-get update && sudo apt-get install -y ca-certificates
sudo update-ca-certificates
# Alpine / 精简镜像
apk add --no-cache ca-certificates && update-ca-certificates
Windows 建议放在 C:phpextrassslcacert.pem,路径中不要带空格和中文。
2. 修改 php.ini
; 两行都要写,作用域不同
curl.cainfo = C:phpextrassslcacert.pem
openssl.cafile = C:phpextrassslcacert.pem
; Linux 示例
; curl.cainfo = /etc/ssl/certs/cacert.pem
; openssl.cafile = /etc/ssl/certs/cacert.pem
区别要记牢:curl.cainfo 只影响 cURL 扩展(Guzzle、Composer 走这条),openssl.cafile 影响 file_get_contents、fopen 等流包装器。只配一个,另一种调用方式照样报错。路径必须写绝对路径,含空格时用双引号包起来。
3. 重启并验证
# PHP-FPM
sudo systemctl restart php8.2-fpm
sudo systemctl reload nginx
# Windows:重启 Apache / IIS / 对应的 PHP-FPM 服务
# 验证配置是否读到
php -i | grep -i cainfo
php -r 'echo ini_get("curl.cainfo"), PHP_EOL;'
# 端到端验证
php -r '$c = curl_init("https://www.example.com"); curl_setopt($c, CURLOPT_RETURNTRANSFER, true); curl_exec($c); echo curl_errno($c) ? curl_error($c) : "OK", PHP_EOL;'
如果 CLI 已经 OK、Web 仍然报错,说明 FPM/Apache 用的不是同一个 php.ini,用 phpinfo() 页面里的 Loaded Configuration File 再确认一次。
四、方案二:自签证书场景的正确验证方式
自签场景下,「关掉校验」是最差解。正确做法是:建一个本地根 CA,用它签发带 SAN 的服务端证书,然后让客户端只信任这个根。
1. 生成根 CA 与服务端证书
# 根 CA(10 年)
openssl req -x509 -newkey rsa:2048 -nodes -days 3650
-keyout rootCA.key -out rootCA.crt
-subj '/CN=My Local Root CA'
# 服务端私钥与 CSR
openssl req -newkey rsa:2048 -nodes
-keyout server.key -out server.csr
-subj '/CN=api.local.test'
# SAN 配置(必须有,现代客户端不认 CN)
cat > san.cnf <<'EOF'
subjectAltName=DNS:api.local.test,DNS:localhost,IP:127.0.0.1
EOF
# 签发(825 天,避开浏览器 398 天上限带来的兼容问题)
openssl x509 -req -in server.csr -CA rootCA.crt -CAkey rootCA.key
-CAcreateserial -out server.crt -days 825 -extfile san.cnf
2. 客户端只信任根证书
$ch = curl_init('https://api.local.test/ping');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CAINFO => __DIR__ . '/certs/rootCA.crt', // 指向根 CA,不是 server.crt
CURLOPT_SSL_VERIFYPEER => true,
CURLOPT_SSL_VERIFYHOST => 2,
]);
$body = curl_exec($ch);
if ($body === false) {
throw new RuntimeException(curl_error($ch), curl_errno($ch));
}
curl_close($ch);
多个自签根可以合并成一个 PEM 文件(直接首尾相接)再传给 CURLOPT_CAINFO;如果要按目录查找,用 CURLOPT_CAPATH 指向经过 c_rehash 处理的目录。
3. 或者把根 CA 装进系统信任库
# Debian / Ubuntu
sudo cp rootCA.crt /usr/local/share/ca-certificates/my-local-root.crt
sudo update-ca-certificates
# RHEL / CentOS
sudo cp rootCA.crt /etc/pki/ca-trust/source/anchors/
sudo update-ca-trust extract
装进系统信任库后,curl.cainfo 指向系统 bundle(/etc/ssl/certs/ca-certificates.crt)即可,不用改任何业务代码。
五、方案三:流包装器、Guzzle、Composer 的 CA 配置
不同调用层读的配置不一样,这是 error 60「改了没用」的头号原因。
file_get_contents / 流包装器
$ctx = stream_context_create([
'ssl' => [
'verify_peer' => true,
'verify_peer_name' => true,
'cafile' => '/etc/ssl/certs/cacert.pem',
],
]);
$html = file_get_contents('https://example.com', false, $ctx);
不传 context 时,流包装器读的是 openssl.cafile,或环境变量 SSL_CERT_FILE。
Guzzle / Laravel HTTP Client
// Guzzle
$client = new GuzzleHttpClient([
'verify' => '/etc/ssl/certs/cacert.pem',
]);
// Laravel
$response = Http::withOptions([
'verify' => '/etc/ssl/certs/cacert.pem',
])->get('https://example.com');
Guzzle 底层是 cURL,verify 不填时读的是 curl.cainfo。
Composer
composer config --global cafile /etc/ssl/certs/cacert.pem
# 或临时用环境变量
COMPOSER_CAFILE=/etc/ssl/certs/cacert.pem composer install
Composer 报 The openssl extension is required for SSL/TLS protection 或同类 60 错误时,优先检查这一项,而不是去关 disable-tls。
六、方案对比表
| 方案 | 配置位置 | 生效范围 | 适用场景 | 推荐度 | 风险 / 代价 |
|---|---|---|---|---|---|
| php.ini 配 curl.cainfo + openssl.cafile | php.ini | 全站 cURL + 流包装器 | 公网 CA 包缺失(Windows / 精简镜像) | ★★★★★ | 需重启服务;路径写错会变成 error 77 |
| 代码里传 CURLOPT_CAINFO | 业务代码 | 单个 cURL 句柄 | 自签 / 内网 CA,仅少数请求 | ★★★★ | 每个调用点都要改,容易漏 |
| stream context 的 cafile | 业务代码 | 单个流请求 | file_get_contents、fopen | ★★★★ | 只对流包装器有效,不覆盖 cURL |
| 根 CA 装入系统信任库 | 操作系统 | 全系统进程 | 容器镜像、自建 CA、多语言共存 | ★★★★ | 需要 root;镜像重建要重做 |
| 把自签证书追加进 cacert.pem | CA 文件 | 全站 | 临时应急 | ★★ | CA 包升级后被覆盖,问题复发且难查 |
| CURLOPT_SSL_VERIFYPEER = false | 业务代码 | 单个请求 | 仅限本机一次性调试 | ☆ | 高危:可被中间人攻击,凭据与数据全裸奔 |
七、排错实录:真实报错与对应处理
下面每一条都是线上真实出现过的报错,按顺序对照即可。
1. cURL error 77: error setting certificate verify locations
cURL error 77: error setting certificate verify locations:
CAfile: C:phpcacert.pem CApath: none
不是证书问题,是路径问题。逐项确认:文件是否真的存在、是不是绝对路径、反斜杠有没有被 PHP 字符串转义吃掉、Web 服务运行账号有没有读权限(Linux 下 chmod 644 + 目录 755)。注意 php -i 显示已配置不代表文件存在——cURL 是运行到请求时才打开这个文件。
2. cURL error 60: unable to get local issuer certificate
两种可能:CA 包没配(回到方案一),或者服务端证书链缺中间证书。用 openssl s_client -showcerts 看返回了几张证书,只有一张就让运维补全 fullchain.pem。客户端能做的临时补救是把中间证书追加到自己的 CA 文件里,但正解在服务端。
3. cURL error 60: self signed certificate in certificate chain
链路里混进了自签根。常见于公司网络做了 TLS 中间解密(Zscaler、FortiGate、抓包代理)。处理方式:把公司的根证书导出为 PEM,配置到 curl.cainfo(多张证书直接拼接)。不要为了绕过它去关校验。
4. cURL error 60: no alternative certificate subject name matches target host name
证书本身可信,但 SAN 里没有你请求的域名。检查是不是用 IP 访问了一个只签了域名的证书,或者自签时漏了 subjectAltName。自签证书请务必带上 -extfile san.cnf。
5. 命令行 curl 正常,PHP 仍然报 60
因为命令行 curl 用的是系统 CA(/etc/ssl/certs/ca-certificates.crt),而 PHP 的 cURL 用的是编译期默认值或 curl.cainfo。二者互不相干,命令行成功不能证明 PHP 配置正确。
6. 改了 php.ini 完全没反应
php --ini # 看 CLI 实际加载的 ini
php -i | grep -i 'Loaded Configuration File'
典型情况:改了 /etc/php/8.2/cli/php.ini,但 Web 走的是 /etc/php/8.2/fpm/php.ini;或者 Docker 里改的是宿主机文件,容器内没挂载进去。改完必须重启 PHP-FPM 或 Apache,reload 有时不够。
八、安全红线与常见误区
- 不要在生产环境写
CURLOPT_SSL_VERIFYPEER => false,也不要把CURLOPT_SSL_VERIFYHOST设成 0。这两行等于关掉 TLS 的核心价值,任何中间人都能解密和篡改流量。 - 不要用
disable-tls之类的全局开关去绕过 Composer 或 SDK 的证书错误。 - 不要用「把自签证书追加到 cacert.pem」当作长期方案,CA 包一升级就被覆盖,半年后同样的问题会以更难查的形式复现。
- 证书过期也会报 error 60,别一看到 60 就怀疑 CA 配置,先看
notAfter。 - 容器镜像里记得装 ca-certificates,并且把
update-ca-certificates放在 Dockerfile 的同一层,否则自建 CA 会在下一次构建时丢失。 - 给 CA 文件加一个更新提醒:
cacert.pem建议随系统包更新,手工下载的版本至少每年换一次。
九、FAQ
Q1:php.ini 里 curl.cainfo 已经配了,为什么还是 error 60?
三个高频原因:一是只配了 curl.cainfo 没配 openssl.cafile,而报错的调用走的是流包装器;二是改的 ini 不是运行时加载的那份(用 php --ini 确认);三是没重启 PHP-FPM。另外注意,代码里显式写了 CURLOPT_CAINFO 时,会覆盖 php.ini 的配置。
Q2:error 60 和 error 77 有什么区别?
60 是证书验证失败(证书本身或信任链的问题),77 是 CA 文件加载失败(路径、权限、格式问题)。看到 77 就别再折腾证书了,去查路径。
Q3:Windows 下 cacert.pem 从哪里来?
从 curl 官网下载:https://curl.se/ca/cacert.pem,放到 C:phpextrasssl,然后在 php.ini 里把 curl.cainfo 和 openssl.cafile 都指向它。不要用浏览器「导出证书」的方式拼凑 CA 包。
Q4:自签证书能用在生产内网吗?
可以,但要用「私有根 CA + 服务端证书(含 SAN)」的结构,并把根 CA 分发到所有客户端的信任库。直接用 openssl req -x509 生成一张自签叶子证书也能跑通,但轮换和吊销会很痛苦。
Q5:Docker 容器里怎么彻底解决?
FROM php:8.2-fpm-alpine
RUN apk add --no-cache ca-certificates
&& update-ca-certificates
# 若使用自建 CA
COPY rootCA.crt /usr/local/share/ca-certificates/my-root.crt
RUN update-ca-certificates
Debian 系镜像用 apt-get install -y ca-certificates && update-ca-certificates。
Q6:为什么浏览器能正常打开,PHP 却报错?
浏览器有自己的信任库,而且会自动补全缺失的中间证书、对自签证书弹窗让你手动放行。PHP 的 cURL 两者都不会做:既不会补链,也不会弹窗。
Q7:能不能在测试环境临时关掉校验?
可以在一次性脚本里关,但不要提交进代码库,更不要通过环境变量让这个开关可能被带到生产。更安全的替代做法是让测试环境也走自签根 CA + CURLOPT_CAINFO,行为和线上一致。
Q8:如何一条命令确认修复成功?
php -r '$c = curl_init("https://example.com"); curl_setopt_array($c, [CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 10]); curl_exec($c); echo curl_errno($c) ? curl_error($c) : "OK", PHP_EOL;'
输出 OK 即表示 CA 配置、证书链、主机名三项全部通过。