PHP cURL error 60 完全解决指南:SSL certificate problem: self signed certificate
错误现象:error 60 到底在说什么
PHP 通过 cURL 访问 HTTPS 地址时,请求直接失败并抛出:
cURL error 60: SSL certificate problem: self signed certificate
在 Laravel / Guzzle 项目里通常会再包一层:
GuzzleHttpExceptionConnectException: cURL error 60: SSL certificate problem: self signed certificate (see https://curl.haxx.se/libcurl/c/libcurl-errors.html)
从 PHP 5.6 起,cURL 扩展默认开启 CURLOPT_SSL_VERIFYPEER(true)与 CURLOPT_SSL_VERIFYHOST(2),也就是说任何 HTTPS 请求都必须通过完整的证书链校验。error 60 对应 libcurl 的 CURLE_PEER_FAILED_VERIFICATION,含义只有一句话:对端证书无法用本机 CA 链验证通过。
冒号后面那段 message 才是真正的线索,常见的有四种:
self signed certificate—— 对端用的是自签证书。unable to get local issuer certificate—— 本机 CA 包里找不到签发者,通常是中间证书缺失或 CA 包不完整。self signed certificate in certificate chain—— 证书链中间夹了一张自签根证书。certificate has expired—— 证书本身过期,跟 CA 配置无关。
根因拆解:信任链断在哪一层
一次 TLS 校验要串起四样东西:站点证书 → 中间证书 → 根证书 → 本机 CA 包。任何一环缺失都会落到 error 60。实际排查中只有三种情况:
- 情况 A:目标站点使用自签证书或私有 CA 签发的证书。常见于内网系统、测试环境、自建 GitLab / Harbor / 内部 API。公共 CA 包天然不可能包含你的私有根证书,必须手动指定。
- 情况 B:本机 PHP 根本没有可用的 CA 包。Windows 版 PHP 编译时未内置 CA 路径,libcurl 找不到默认的 cacert 文件,于是所有公网 HTTPS 请求全部失败。这是 Windows 上最高频的成因,也是需要配置 php.ini 的原因。
- 情况 C:CA 包存在但不完整或过期。比如服务器只下发了站点证书、没下发中间证书(
openssl s_client里能看到verify error: 21),或者容器镜像里的 ca-certificates 是几年前的老包,缺新的根证书。
还有一个高频的误区:curl.cainfo 只作用于 cURL 扩展;file_get_contents('https://...')、SoapClient、stream_socket_client 走的是 OpenSSL 流封装,读的是 openssl.cafile。两个都要配,否则会出现「cURL 修好了、别的地方还在报错」的诡异现象。
快速定位:三条命令判断你属于哪种情况
1. 看对端证书是谁签的
openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates
如果 issuer 和 subject 完全一致,就是自签证书(情况 A);如果 issuer 是某个中间 CA 但链不完整,属于情况 C。同时在 s_client 输出里确认 Verify return code 是否为 0。
2. 看 PHP 实际加载的 ini 与 CA 配置
php --ini
php -i | grep -iE 'curl.cainfo|openssl.cafile|Loaded Configuration File'
Windows 下用:
php -i | findstr /i "cainfo cafile"
要确认两件事:Loaded Configuration File 是不是你改的那个 php.ini;curl.cainfo 是否显示了你写的路径。显示 no value 就说明没生效。
3. 一条命令复现并打印错误号
php -r '$c = curl_init("https://api.example.com"); curl_setopt($c, CURLOPT_RETURNTRANSFER, true); curl_exec($c); echo curl_errno($c), ": ", curl_error($c), PHP_EOL;'
把这段输出和 s_client 的结果对照,基本一眼就能分出是 A、B 还是 C。
方案一:为 PHP 配置正确的 CA bundle(覆盖绝大多数场景)
Windows
- 下载 curl 官方维护的 CA 包:
curl -o C:/php/cacert.pem https://curl.se/ca/cacert.pem - 编辑
C:/php/php.ini,两行都写,不要只写一行:
curl.cainfo = "C:/php/cacert.pem"
openssl.cafile = "C:/php/cacert.pem"
反斜杠写法 "C:phpcacert.pem" 同样有效,但正斜杠更不容易被转义坑到。
- 重启 Apache / IIS(
iisreset);CLI 没有守护进程,改完即生效。
Linux / macOS
# Debian / Ubuntu
sudo apt-get update && sudo apt-get install -y ca-certificates
sudo update-ca-certificates
# RHEL / CentOS / Rocky / AlmaLinux
sudo dnf install -y ca-certificates
sudo update-ca-trust
然后在 php.ini 里指向系统 CA 包:
- Debian / Ubuntu:
/etc/ssl/certs/ca-certificates.crt - RHEL 系:
/etc/pki/tls/certs/ca-bundle.crt - Alpine:
/etc/ssl/cert.pem - macOS(Homebrew PHP):
/opt/homebrew/etc/openssl@3/cert.pem或/usr/local/etc/openssl@3/cert.pem
curl.cainfo = "/etc/ssl/certs/ca-certificates.crt"
openssl.cafile = "/etc/ssl/certs/ca-certificates.crt"
Docker 镜像
RUN apk add --no-cache ca-certificates && update-ca-certificates
# 或 Debian 系
RUN apt-get update && apt-get install -y ca-certificates && update-ca-certificates
重启并验证
sudo systemctl restart php8.2-fpm
sudo systemctl restart apache2
# Windows IIS
iisreset
php -r '$c = curl_init("https://www.example.com"); curl_setopt($c, CURLOPT_RETURNTRANSFER, true); curl_exec($c); echo curl_errno($c) === 0 ? "OK" : curl_error($c);'
输出 OK 说明配置已生效。注意:改了 php.ini 一定要重启 PHP-FPM,否则你验证的仍是旧进程里的旧配置。
方案二:自签证书 / 私有 CA 的正确接入方式
正确做法不是关掉校验,而是把「你信任的那张根证书」显式告诉 cURL。
1. 取出根证书
openssl s_client -connect internal.example.local:443 -showcerts </dev/null 2>/dev/null
| openssl x509 -outform PEM > internal-root-ca.pem
生产环境更稳妥的做法是直接从你的 CA 服务器导出根证书,而不是从服务端抓——否则一旦连到假冒服务端,抓回来的就是攻击者的证书。
2. 在代码里指定 CURLOPT_CAINFO
<?php
$ch = curl_init('https://internal.example.local/api/health');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CAINFO => __DIR__ . '/certs/internal-root-ca.pem',
]);
$body = curl_exec($ch);
if ($body === false) {
throw new RuntimeException('cURL error ' . curl_errno($ch) . ': ' . curl_error($ch));
}
curl_close($ch);
3. Guzzle / Laravel HTTP 客户端
$client = new GuzzleHttpClient([
'verify' => '/var/www/app/certs/internal-root-ca.pem',
]);
// Laravel
Http::withOptions(['verify' => storage_path('certs/internal-root-ca.pem')])
->get('https://internal.example.local/api');
4. 同时要访问公网和内网:合并 CA 包
cat /etc/ssl/certs/ca-certificates.crt internal-root-ca.pem > /etc/ssl/certs/combined.pem
然后 curl.cainfo = "/etc/ssl/certs/combined.pem"。合并文件里出现重复证书是无害的,但建议每次系统 CA 更新后重新合并一次,避免新根证书丢失。
5. 多张私有根证书:用 CURLOPT_CAPATH
curl_setopt($ch, CURLOPT_CAPATH, '/etc/ssl/private-cas');
目录里的证书文件名必须经过 openssl rehash /etc/ssl/private-cas 生成哈希名,否则 cURL 找不到任何证书。
方案对比:选哪一条
| 方案 | 适用场景 | 安全性 | 维护成本 | 推荐度 |
|---|---|---|---|---|
配置 php.ini 的 curl.cainfo + openssl.cafile |
公网 HTTPS,Windows PHP 环境 | 高 | 低,随系统 CA 包更新即可 | ★★★★★ |
CURLOPT_CAINFO 指向私有根证书 |
内网自签证书、私有 CA | 高 | 中,证书轮换需同步文件 | ★★★★★ |
| 合并 bundle(系统 CA + 私有根) | 同一进程既要访问公网又要访问内网 | 高 | 中,每次系统更新需重新合并 | ★★★★ |
CURLOPT_CAPATH 目录 |
需要信任多张私有根证书 | 高 | 中,需 rehash | ★★★ |
关闭 VERIFYPEER / VERIFYHOST |
仅限本机一次性调试 | 极低,可被中间人劫持 | — | ☆(生产禁用) |
排错实录:真实报错与对应修复
报错 1:self signed certificate
cURL error 60: SSL certificate problem: self signed certificate
对端确实是自签。按方案二把根证书通过 CURLOPT_CAINFO 传进去即可,不要改 php.ini 里的公网 CA 包去迁就它。
报错 2:unable to get local issuer certificate
cURL error 60: SSL certificate problem: unable to get local issuer certificate
十有八九是服务端只发了站点证书、没发中间证书。openssl s_client 会显示 verify error: 21。修复优先级:① 让服务端配置 fullchain(Nginx 的 ssl_certificate 指向 fullchain.pem);② 客户端把中间证书拼进 CAINFO 文件。
报错 3:error setting certificate verify locations
cURL error 77: error setting certificate verify locations: CAfile: /etc/ssl/certs/ca-certificates.crt CApath: none
路径写错、文件不存在、或 PHP 进程没有读权限。依次检查:ls -l /etc/ssl/certs/ca-certificates.crt、SELinux 上下文、Windows 上路径是否被转义、容器里是否漏装 ca-certificates。这个错误说明「配置生效了,但文件打不开」,和 error 60 是两回事。
报错 4:主机名不匹配
cURL error 51: SSL: no alternative certificate subject name matches target host name 'api.example.com'
这不是 CA 问题,是证书 SAN 里没有你访问的域名。用 openssl x509 -noout -text 查看 SAN 字段,改用证书上列出的域名访问。
报错 5:证书过期
cURL error 60: SSL certificate problem: certificate has expired
对端证书过期,和本地 CA 配置无关。用 openssl s_client 看 notAfter,通知对方续签。此时改任何 CA 配置都不会有用。
报错 6:composer 正常,业务代码却报 60
[ComposerDownloaderTransportException] curl error 60 while downloading https://repo.packagist.org/packages.json
反过来也成立:composer 能跑而你的代码报错,说明 composer 用的是自带的 composer/ca-bundle,而你的 PHP 没有配 curl.cainfo。这条现象本身就是「php.ini 没配」的铁证。
报错 7:改了 php.ini 却毫无变化
99% 是改错了文件或没重启。CLI 与 PHP-FPM 经常读不同的 php.ini:php --ini 看 CLI 的,php-fpm -i | grep 'Loaded Configuration' 看 FPM 的。Docker 里改了挂载的 ini 却没重建/重载容器,同样不会生效。
不要做的事:关闭证书校验的代价
网上流传最广的答案是这两行:
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
它们的实际效果是:任何人只要能劫持 DNS、控制上游路由或与你处于同一网络,就能用任意证书冒充目标服务器,并完整拿到你的请求体、Cookie 和 Authorization 头。生产环境应当视为禁止。
确实需要本地临时跳过(例如一次性抓包对比)时,至少做成开关而不是写死:
$verify = filter_var(getenv('HTTP_TLS_VERIFY') ?: 'true', FILTER_VALIDATE_BOOLEAN);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, $verify);
并确保这个环境变量只出现在 local 环境的 .env 里,不要进版本库的默认配置。
FAQ
已经配了 curl.cainfo,为什么 php -i 里还是 no value?
三个原因:改的不是实际加载的那个 php.ini;改完没有重启 PHP-FPM / Apache;或者路径写错导致 PHP 解析失败(Windows 上反斜杠未转义时尤其常见)。先用 php --ini 确认文件路径,再重启,最后用 php -i | grep cainfo 复核。
浏览器能正常打开,PHP 却报 error 60,为什么?
浏览器有自己的信任库,而且允许用户手动「继续访问」不安全站点;PHP 的 cURL 没有交互界面,校验不过就直接失败。浏览器能打开不代表证书链是完整的——很多浏览器会自动补全缺失的中间证书,cURL 不会。
用的是 Let’s Encrypt 免费证书,也会报 60 吗?
会。最常见的是服务端漏配中间证书,或者客户端的 CA 包太旧、缺 ISRG Root X1。执行 sudo update-ca-certificates 更新系统 CA 包,再确认服务端下发的是 fullchain。
cacert.pem 需要定期更新吗?
需要。curl 官方大约每半年发布一次更新。建议随系统包管理更新(ca-certificates),Windows 手工维护的场景可以写个计划任务每年拉一次新文件。
CURLOPT_SSL_VERIFYPEER 关了还是报错?
因为还有 CURLOPT_SSL_VERIFYHOST(默认 2)、以及 OpenSSL 流封装的 context 选项。如果代码里用的是 file_get_contents 或 SoapClient,需要改的是 stream_context 里的 verify_peer 与 verify_peer_name,改 cURL 选项没用。
有没有不用改 php.ini 的全局办法?
libcurl 会读取 CURL_CA_BUNDLE 和 SSL_CERT_FILE 环境变量,可以作为兜底。但 php.ini 里的 curl.cainfo 优先级更高,且 FPM / 容器环境下环境变量不一定能传进去,所以仍推荐以 php.ini 为准。
怎么一次性验证整条链是否健康?
先用 openssl s_client -connect host:443 -servername host -showcerts 确认 Verify return code: 0 (ok),再用 curl -vI https://host 确认系统 curl 正常,最后跑前面的 PHP 一行命令。三层都通过,才算真的修好。