PHP OpenSSL 证书验证失败怎么排查?从 cURL error 60 到 CA 根证书配置的完整指南
PHP 报 openssl 证书验证失败,绝大多数情况是 PHP 进程找不到可信 CA 根证书,或服务端没有下发中间证书,而不是站点证书本身无效;先执行 php -r 'var_dump(openssl_get_cert_locations());',确认 default_cert_file 指向的文件真实存在。 最快的修复方式:执行 curl -fsSL https://curl.se/ca/cacert.pem -o /etc/ssl/certs/cacert.pem,在 php.ini 中同时写入 openssl.cafile 与 curl.cainfo 两行,重启 php-fpm 后 error 60 通常立即消失。 用 openssl s_client -connect example.com:443 -servername example.com -showcerts 检查服务端是否返回 2 张以上证书;如果只有 1 张,说明链路不完整,需要改用 fullchain.pem。 PHP 5.6 起默认开启 peer 验证,把 CURLOPT_SSL_VERIFYPEER 设为 false 只是掩盖问题,会让接口暴露在中间人攻击下,不建议在生产环境使用。 CA 包建议每 3-6 个月更新一次;Let's Encrypt 证书有效期 90 天,商业 DV 证书约 0-300 元/年,OV 证书约 800-3000 元/年,验证失败问题与证书品牌基本无关。
PHP 为什么会报 openssl 证书验证失败?先定位根本原因
先给结论:绝大多数“php openssl证书验证失败”并不是证书本身有问题,而是 PHP 进程找不到可信的 CA 根证书,或者服务端没有下发中间证书,导致 OpenSSL 无法按 RFC 5280 第 6 节的路径构建规则拼出一条从站点证书到受信根的完整链。换句话说,报错说的是“我不认识签发者”,而不是“这张证书是假的”。
同样的根因,在不同调用栈上会长成三种样子,先认脸再定位:
| 报错来源 | 原文(可直接搜索) | 常见环境 |
|---|---|---|
| cURL 扩展 | cURL error 60: SSL certificate problem: unable to get local issuer certificate | PHP 5.6+ 任意版本,最常见于 Guzzle、Composer |
| PHP stream(file_get_contents / stream_socket_client) | error:1416F086:SSL routines:tls_process_server_certificate:certificate verify failed | OpenSSL 1.1.1 |
| 同上,OpenSSL 3.x | error:0A000086:SSL routines::certificate verify failed | OpenSSL 3.0+(Debian 12、Ubuntu 22.04) |
错误码从 1416F086 变成 0A000086,是 OpenSSL 3.0 重排了错误码位宽导致的,含义完全一致,别被新码吓到。据 OpenSSL 官方文档,0A 是新的库编号前缀,后四位 0086 仍是 certificate verify failed。
为什么以前不报、升级 PHP 后突然报?因为 PHP 自 5.6 起把 stream 上下文的 verify_peer 与 verify_peer_name 默认值改成了 true(此前是 false),而 php.ini 里 openssl.cafile 的默认值一直是空字符串。空值意味着 OpenSSL 回退到编译期默认路径——通常是 /usr/lib/ssl/cert.pem 或 /etc/ssl/certs 目录——而最小化安装的 Docker 镜像(如 php:7.4-cli 早期标签)里这个文件往往根本不存在。先确认三件事:
# 1) PHP 侧:确认 cafile/capath 是否为空、OpenSSL 版本是多少
php -i | grep -E 'openssl.cafile|openssl.capath|OpenSSL Library Version'
# 典型问题输出:openssl.cafile => no value ; openssl.capath => no value
# 2) 系统侧:编译期回退路径下的 CA 包到底在不在
ls -l /usr/lib/ssl/cert.pem /etc/ssl/certs/ca-certificates.crt 2>&1
# 3) 服务端侧:看它到底下发了几张证书(只有 1 个 s: 就是链不完整)
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null
| grep -E '^ *[0-9]+ s:|i:'
六类根因按实际出现频率排序,可直接对照上一步的输出排查:
| 排名 | 根因 | 快速判定依据 |
|---|---|---|
| ① | CA 包缺失(镜像精简、未装 ca-certificates) | 第 2 步 ls 报 No such file |
| ② | CA 包过期,CentOS 7 自带 ca-certificates 常停在 2014–2018 年版本 | rpm -q ca-certificates 日期过旧 |
| ③ | 服务端证书链不完整,只发 leaf 证书 | 第 3 步只输出 1 个 s: |
| ④ | 未启用 SNI,握手拿到默认站点证书导致域名不匹配 | 去掉 -servername 后 subject 变了 |
| ⑤ | 系统时间偏差超出 notBefore/notAfter | date -u 与证书有效期对比 |
| ⑥ | OpenSSL 版本过旧,不支持 SHA-256 或新根 | OpenSSL Library Version < 1.0.2 |
历史参照很有说服力:2021-09-30 Let’s Encrypt 的 DST Root CA X3 根证书到期,大量未更新 CA 包的 PHP 5.6 / 7.0 环境集中爆发 error 60;据 Let’s Encrypt 官方公告,2024-06 之后签发的新证书默认不再附带交叉签名链,老客户端必须自己内置 ISRG Root X1 才能验证通过。
最后一步是区分“证书无效”和“验证失败”——这两者的修复方向完全相反:
# 只解析证书本身,不涉及信任链
openssl x509 -in cert.pem -noout -dates -issuer -subject
# 输出示例:
# notBefore=Mar 1 00:00:00 2024 GMT
# notAfter=May 30 23:59:59 2025 GMT
# issuer=C=US, O=Let's Encrypt, CN=R3
# subject=CN=example.com
如果 notAfter 还在未来、subject 也与域名一致,却依然报 certificate verify failed,那问题百分之百在信任链或 CA 配置侧,而不是证书本身——下一步该去查 openssl.cafile 指向的文件、以及服务端是否补发了中间证书。
从报错到修复:PHP OpenSSL 证书验证失败的 6 步实操流程
先给结论:cURL error 60: SSL certificate problem: unable to get local issuer certificate 极少是业务代码写错,绝大多数情况是「PHP 加载的 CA 包」和「libcurl 期望的 CA 包」不是同一个文件。按下面 6 步走,每步都能把排查范围砍掉一半。
第 1 步:先记录三个版本号。版本决定了你后面能看懂哪些错误码、能用哪些参数:
php -v
# PHP 8.2.18 (cli) ...
php -i | grep -E "openssl|curl" | head -20
# OpenSSL Library Version => OpenSSL 3.0.13 30 Jan 2024
# cURL Information => 7.81.0
# SSL Version => OpenSSL/3.0.13
为什么先看这个:OpenSSL 3.x 的错误栈是 error:0A000086:SSL routines::certificate verify failed,而 1.1.1 是 error:1416F086:SSL routines:tls_process_server_certificate:certificate verify failed;curl 7.81 与 8.x 对同一条件的措辞也不同。搜索报错时带上版本号能省大量时间。
第 2 步:确认 PHP 实际在用哪个 CA 文件。
php -r 'var_dump(openssl_get_cert_locations());'
# ["default_cert_file"] => string(23) "/usr/lib/ssl/cert.pem"
# ["default_cert_dir"] => string(19) "/usr/lib/ssl/certs"
ls -l /usr/lib/ssl/cert.pem
# -rw-r--r-- 1 root root 217864 ... /usr/lib/ssl/cert.pem
据 PHP 手册,这两个默认值来自编译时探测结果,与 openssl.cafile 是「覆盖」关系。判断标准很粗暴:文件存在且大于 100KB(正常 cacert.pem 约 200–230KB);0 字节、软链断裂或路径不存在,后面必然 error 60。
第 3 步:检查服务端有没有发完整证书链。
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null
| grep -E "^ *[0-9]+ s:|^ *i:"
# 0 s:CN = example.com
# i:C = US, O = Let's Encrypt, CN = R3
# 1 s:C = US, O = Let's Encrypt, CN = R3
# i:C = US, O = Internet Security Research Group, CN = ISRG Root X1
出现 2–3 段 s:/i: 属正常;只有 1 段说明服务端漏发中间证书。据 Let’s Encrypt 文档,服务器必须发送「叶子证书 + 中间证书」的完整链,只配 fullchain.pem 的前半段是最常见的配置事故,客户端无法凭叶子证书自行补齐。
第 4 步:脱离 PHP,单独验证链路。
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt -untrusted chain.pem cert.pem
# cert.pem: OK
# 或:error 20 at 0 depth lookup: unable to get issuer certificate
返回 OK 说明系统 CA 包本身没问题,锅在 PHP 配置;返回 unable to get issuer certificate 则是缺中间证书,回到第 3 步找服务端要 fullchain。命令语义参见 OpenSSL 文档 openssl-verification-options:-untrusted 提供辅助链,-CAfile 提供信任锚。
第 5 步:更新 CA 包(按发行版选命令)。
| 发行版 | CA 包路径 | 更新命令 |
|---|---|---|
| Debian / Ubuntu | /etc/ssl/certs/ca-certificates.crt | apt-get install --only-upgrade ca-certificates && update-ca-certificates |
| RHEL / CentOS / Rocky | /etc/pki/tls/certs/ca-bundle.crt | yum update -y ca-certificates && update-ca-trust extract |
| Alpine | /etc/ssl/certs/ca-certificates.crt | apk add --no-cache ca-certificates && update-ca-certificates |
第 6 步:在 php.ini 固定路径,然后重载 FPM。
; php.ini 中同时设置,两者指向同一个文件
openssl.cafile = /etc/ssl/certs/ca-certificates.crt
curl.cainfo = /etc/ssl/certs/ca-certificates.crt
systemctl reload php8.2-fpm # 或 service php-fpm restart
php -i | grep -E "cafile|cainfo" # 复核生效值,注意这是 CLI 的 ini
两个键必须都设,原因在于作用域不同:openssl.cafile 影响 PHP stream 封装与 openssl 扩展,curl.cainfo 只影响 ext/curl;不设后者时 libcurl 会退回编译期内置路径(常见 /etc/pki/tls/certs/ca-bundle.crt),两套 CA 库版本不一致时就会出现「file_get_contents() 成功、Guzzle 报 60」的诡异现象。curl.cainfo 的默认值是空字符串,即使用 libcurl 编译时默认值——这一点 PHP 手册写得明确。最后用 CLI 的 ini 复核时记得确认 FPM 读的是同一个 php.ini,否则改了半天没生效。
6 步走完仍报 60,下一个怀疑对象是环境变量:HTTPS_PROXY、SSL_CERT_FILE 被注入到 FPM 的 env 中会静默覆盖上述配置,可用 phpinfo() 的 Environment 区块或 cat /proc/<fpm-pid>/environ 核对。如果报错从 unable to get local issuer certificate 变成 certificate has expired,那已经是证书有效期问题,与 CA 配置无关了。
配置与命令示例:php.ini、cURL、stream context 三处怎么写
先回答最常被问到的那个问题:php.ini、cURL 选项、stream context 到底该在哪一处配 CA?答案是「按扩展分家」——OpenSSL 扩展和 cURL 扩展是两条独立的代码路径,各读各的指令,所以 php.ini 里的两行必须同时写,只写一行时 php openssl证书验证失败 的错误很可能只在其中一条路径上消失。
| 配置位置 | 生效范围 | 默认值(PHP 8.2) | 只设这一处的后果 |
|---|---|---|---|
openssl.cafile(php.ini) |
openssl 扩展:stream context、fsockopen、SOAP、部分 mail 场景 |
空字符串,回退到编译期默认路径 | curl_exec() 仍可能返回 error 60 |
curl.cainfo(php.ini) |
curl 扩展:curl_exec() |
空字符串,回退到 libcurl 编译内置路径 | file_get_contents('https://…') 仍验证失败 |
CURLOPT_CAINFO / ssl.cafile |
仅当前这一次请求 | 无(不设则继承 php.ini) | 每个调用点都要重复写,容易漏 |
在 php.ini(以 PHP 8.2 为例,路径通常是 /etc/php/8.2/fpm/php.ini 或 /etc/php.ini)中写入两行,然后重启 php-fpm 并用 php -i | grep -E 'openssl.cafile|curl.cainfo' 确认生效:
; php.ini —— openssl 扩展与 curl 扩展各读一行,缺一不可
openssl.cafile = /etc/ssl/certs/cacert.pem
curl.cainfo = /etc/ssl/certs/cacert.pem
; 可选:capath 指向哈希目录,与 cafile 二选一即可
; openssl.capath = /etc/ssl/certs
CA 包来源建议直接用 curl 官方维护的 Mozilla 捆绑包(据 curl.se 文档,该文件随 Firefox 的 NSS 根证书库更新)。下载后必须校验条数,否则文件被截断时你只会看到另一个报错:
# 下载并修正权限(644 保证 php-fpm 的 www-data 用户可读)
curl -fsSL https://curl.se/ca/cacert.pem -o /etc/ssl/certs/cacert.pem
&& chmod 644 /etc/ssl/certs/cacert.pem
# 核对证书条数,2024 年版约 140 条以上;明显偏少说明下载不完整
grep -c "BEGIN CERTIFICATE" /etc/ssl/certs/cacert.pem
cURL 代码里把验证开关显式写出来,便于代码审计(PHP 5.6 起 CURLOPT_SSL_VERIFYPEER 默认为 true,但很多老代码仍在关它):
<?php
// 适用于 PHP 7.4 / 8.x
$ch = curl_init('https://example.com/api');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_SSL_VERIFYPEER => true, // 默认 true,显式写出便于审计
CURLOPT_SSL_VERIFYHOST => 2, // 2 = 校验证书 CN/SAN 与主机名匹配
CURLOPT_CAINFO => '/etc/ssl/certs/cacert.pem',
CURLOPT_TIMEOUT => 10,
]);
$resp = curl_exec($ch);
if ($resp === false) {
error_log('curl: '.curl_error($ch).' / '.curl_errno($ch));
}
而 file_get_contents、fsockopen、Guzzle 之外的轻量 HTTP 客户端走的是 stream context,需要单独给 ssl 段,注意 peer_name 在通过 IP 直连或做了 SNI 分流时尤其重要:
<?php
$ctx = stream_context_create(['ssl' => [
'verify_peer' => true,
'verify_peer_name' => true,
'allow_self_signed' => false,
'cafile' => '/etc/ssl/certs/cacert.pem',
'SNI_enabled' => true,
'peer_name' => 'example.com',
]]);
$html = file_get_contents('https://example.com', false, $ctx);
临时调试可以用环境变量兜底:SSL_CERT_FILE=/etc/ssl/certs/cacert.pem php test.php,据 OpenSSL 文档,SSL_CERT_FILE 与 SSL_CERT_DIR 会覆盖默认的证书查找路径。但 php-fpm 下环境变量不会自动透传,长期方案仍是写进 php.ini 或 pool 配置的 env[SSL_CERT_FILE] 段。
最后是 Composer 这个高频踩坑点:composer config --global cafile /etc/ssl/certs/cacert.pem 只解决 Composer 自身下载包时的验证;从 Composer 2.7 起它已自带 CA 包(composer/ca-bundle),但这不影响你业务代码里 curl 扩展的行为——两者是不同进程、不同配置源。如果你在 Composer 之外还想统一,直接 require composer/ca-bundle 并在代码里取 CaBundle::getSystemCaRootBundlePath() 传给 CURLOPT_CAINFO,可以彻底绕开 php openssl证书验证失败 的路径不一致问题。
CA 包怎么选:系统 CA、curl.se cacert.pem 与 composer/ca-bundle 对比
遇到 cURL error 60: SSL certificate problem: unable to get local issuer certificate 时,第一反应往往是”去下载一个 cacert.pem 塞进去”,但选错方案会在半年后以同样的报错回归。先看一张对比表,再决定动哪里。
| 方案 | 配置位置 | 适用场景 | 更新方式 | 成本 |
|---|---|---|---|---|
| 系统 ca-certificates | 系统默认路径 | Debian 12、Ubuntu 22.04/24.04、RHEL 9 | apt/yum + update-ca-* | 0 元 |
| curl.se cacert.pem | php.ini 的 openssl.cafile/curl.cainfo |
容器镜像、EOL 系统、Windows PHP | 自建 cron,每 3 个月 | 0 元 |
| composer/ca-bundle | Composer 依赖 | Composer 管理的项目 | composer update |
0 元 |
CURLOPT_CAINFO |
应用代码 | 固定信任锚的支付/回调 | 发版 | 人力 |
| 私有 CA 自签 | 自建根证书 | 内网服务、mTLS | 手工分发 | 人力 |
方案 A:系统 CA 包,为什么大多数公网业务该先用它? 因为根证书的增删本质是安全更新,交给发行版维护比自己维护可靠。Debian/Ubuntu 的 CA 包落在 /etc/ssl/certs/ca-certificates.crt,RHEL 9 在 /etc/pki/tls/certs/ca-bundle.crt;PHP 的 openssl.cafile 与 curl.cainfo 默认值为空,此时 OpenSSL 和 libcurl 会回退到编译期写入的默认路径,通常就是你不需要改 php.ini 的原因。
# Debian 12 / Ubuntu 22.04+:安装并刷新系统 CA 包
apt-get install -y ca-certificates
update-ca-certificates --fresh # 重建 /etc/ssl/certs/ca-certificates.crt
# RHEL 9 / CentOS Stream 9:等价的刷新命令
update-ca-trust extract
# 验证 PHP 实际使用的 CA 文件与解析结果
php -r 'var_dump(openssl_get_cert_locations()["default_cert_file"]);'
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt example.com.pem
它的短板很明确:CentOS 7(2024-06 EOL)、Debian 10 等系统的 ca-certificates 包内容已冻结,新根证书进不来;而 debian:12-slim 这类精简镜像可能压根没装 ca-certificates——这正是同一个 php openssl证书验证失败 报错在本地不复现、在容器里必现的常见原因。
方案 B:curl.se 官方 cacert.pem,可控性最强。 单文件、跨发行版一致,适合容器与 Windows PHP。据 curl 官方文档,cacert.pem 由 Mozilla 根证书库导出,建议在 Dockerfile 里固化而非运行时下载:
# 构建期固化,避免运行时网络依赖
COPY cacert.pem /etc/ssl/certs/cacert.pem
RUN printf 'openssl.cafile=/etc/ssl/certs/cacert.pemncurl.cainfo=/etc/ssl/certs/cacert.pemn'
> /usr/local/etc/php/conf.d/ca.ini
# 每 3 个月更新一次,保留上一版本便于回滚
0 3 1 */3 * curl -fsSL https://curl.se/ca/cacert.pem -o /etc/ssl/certs/cacert.pem.new
&& mv /etc/ssl/certs/cacert.pem /etc/ssl/certs/cacert.pem.bak
&& mv /etc/ssl/certs/cacert.pem.new /etc/ssl/certs/cacert.pem
&& systemctl reload php8.3-fpm
方案 C:composer/ca-bundle。 只对 Composer 生态项目划算:Composer 自己就靠它找根证书,代码里用 ComposerCaBundleCaBundle::getSystemCaRootBundlePath() 取路径,随 composer update 一起更新。非 Composer 项目为一个路径函数引入依赖并不值得。
方案 D:私有 CA 自签。 用于内网服务或 mTLS 双向认证。证书本身 0 元,成本在运维:根证书分发、有效期轮换、CRL/OCSP 吊销流程都要写进手册,否则一旦私钥泄露只能全量重签。
怎么选? 公网业务优先方案 A,用方案 B 兜底;容器化部署统一走方案 B 并写进镜像构建流程;内网通信走方案 D。至于在生产环境长期把 CURLOPT_SSL_VERIFYPEER 设为 false——那不是方案,是把 TLS 降级成明文传输,同时让后续所有证书问题都变成静默故障。
常见报错逐条排查:error 60、error 51、error:1416F086 分别怎么处理
同一条链验证失败,在 PHP 里会以三种面孔出现:cURL 错误码(60/51)、OpenSSL 错误栈(error:1416F086 或 error:0A000086)、以及 PHP Warning(stream_socket_client())。先看报错原文,再决定用哪条命令定位,不要一上来就 curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false) 关校验——那只是把问题藏起来。
cURL error 60: SSL certificate problem: unable to get local issuer certificate
这是 php openssl证书验证失败 场景里出现频率最高的一条,含义是 OpenSSL 拿手里的 CA 库追不到签发者:要么服务端没发中间证书,要么客户端 CA 包不全。先确认服务端发了几张证书:
# 统计服务端实际下发的证书张数,期望 >= 2(leaf + 中间证书)
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null
| grep -c "BEGIN CERTIFICATE"
# 用系统 CA 包验证整条链,返回 0 才算通过
openssl s_client -connect example.com:443 -servername example.com
-CAfile /etc/ssl/certs/ca-certificates.crt /dev/null | grep "Verify return code"
# 典型输出:Verify return code: 20 (unable to get local issuer certificate) → 链没搭起来
# 典型输出:Verify return code: 0 (ok) → 服务端链完整,问题在客户端 CA 配置
PHP 侧对应两个 ini 项,默认值都是空:curl.cainfo(libcurl 用)与 openssl.cafile(stream 用)。两者不设置时,cURL 会去编译期硬编码的路径找 CA 包,在容器里常常不存在,于是报 error 60。
cURL error 60: SSL certificate problem: certificate has expired
- NGINX / APACHE / TOMCAT / IIS 证书配置 · SSL证书安装
- 中小企业云服务器安全代运维(防攻击方案)
- APP/小程序 HTTPS · SSL网站加密证书 · CA证书配置
别急着换站点证书——过期的很可能是 CA 包里的根证书。2021 年 9 月 30 日 DST Root CA X3 到期时,大量老镜像里的 cacert.pem 就是因此翻车的。cacert.pem 是 bundle,openssl x509 默认只读第一张,要逐张拆开看:
# 拆分 CA bundle(OpenSSL 1.1.1 / 3.x 通用)
mkdir -p /tmp/ca && rm -f /tmp/ca/*.pem
awk '/BEGIN CERTIFICATE/{n++} {print > ("/tmp/ca/" n ".pem")}' /etc/ssl/certs/cacert.pem
for f in /tmp/ca/*.pem; do openssl x509 -in "$f" -noout -subject -enddate; done | paste - -
发现 notAfter 已过期的条目,直接换成 curl 官网维护的最新 cacert.pem,或改用发行版自带的 /etc/ssl/certs/ca-certificates.crt(Debian/Ubuntu)//etc/pki/tls/certs/ca-bundle.crt(RHEL 系)。
cURL error 51: SSL: no alternative certificate subject name matches target host name
用 IP 直连 HTTPS 时的典型症状:证书 SAN 里根本没有这个 IP。按 RFC 5280,校验对象是 SAN 扩展,不是 CN。正确做法是让连接 IP 不变、Host 与 SNI 保持域名:
// PHP >= 5.5.0 / libcurl >= 7.21.3 支持 CURLOPT_RESOLVE
$ch = curl_init('https://api.example.com/health');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_SSL_VERIFYPEER => true,
// 把域名钉到指定 IP,Host 头与 SNI 仍是 api.example.com,证书校验才成立
CURLOPT_RESOLVE => ['api.example.com:443:1.2.3.4'],
]);
error:1416F086 与 error:0A000086 是同一件事
OpenSSL 3.0 起错误码格式从 error:1416F086:SSL routines:tls_process_server_certificate:... 改成 error:0A000086:SSL routines::...,低位原因码同为 0x86(即 X509_V_ERR_CERT_HAS_EXPIRED 之外的一般性验证失败),据 OpenSSL 3.0 CHANGES 说明,库名被压缩、函数名被省略。含义与排查手段完全一致,别被新格式带偏。
PHP Warning: Peer certificate CN=’*.example.com’ did not match expected CN=’api.example.com’
通配符只覆盖一级:按 RFC 6125,*.example.com 匹配 a.example.com,不匹配 a.b.example.com;且 PHP 5.6 起优先校验 SAN。若确实是域名写法问题,换证书;若只是连接层用 IP、逻辑层用域名,则显式设置 peer_name:
$ctx = stream_context_create(['ssl' => [
'verify_peer' => true,
'verify_peer_name' => true,
'peer_name' => 'api.example.com', // 校验用的主机名,与 SNI 一致
'cafile' => '/etc/ssl/certs/ca-certificates.crt',
]]);
openssl verify 报 unable to get issuer certificate
几乎可以断定服务端只发了 leaf。Nginx 必须写 ssl_certificate fullchain.pem; 而非 cert.pem;fullchain 顺序为 leaf 在前、中间证书在后,顺序反了同样会失败。据 Let’s Encrypt 文档,fullchain.pem 就是给 ssl_certificate 用的那一个文件。
# 本地复现验证:-untrusted 传入中间证书,-CAfile 传入根
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt -untrusted chain.pem cert.pem
# 成功:cert.pem: OK
# 失败:error 20 at 0 depth lookup: unable to get local issuer certificate
| 报错文本 | 首查手段 | 常见根因 | 修复 |
|---|---|---|---|
| error 60: unable to get local issuer certificate | s_client -showcerts 数证书张数 |
服务端漏发中间证书 / 客户端 CA 缺失 | Nginx 改 fullchain;PHP 设 curl.cainfo |
| error 60: certificate has expired | 拆分 CA bundle 查 -enddate |
根证书过期(如 DST Root CA X3) | 更新 cacert.pem |
| error 51: no alternative certificate subject name | 看证书 SAN | IP 直连,SAN 无该 IP | CURLOPT_RESOLVE 或 peer_name |
| error:1416F086 / error:0A000086 | 同上,看 Verify return code |
链验证失败(OpenSSL 3.x 换了码格式) | 按链验证思路处理 |
| CN/SAN did not match expected CN | openssl x509 -text | grep DNS |
通配符只匹配一级 | 换证书或显式 peer_name |
| unable to get issuer certificate | openssl verify -untrusted |
服务端只发 leaf | 用 fullchain.pem,leaf 在前 |
PHP 与 OpenSSL 版本差异:老系统上还有哪些额外的坑
为什么升级 PHP 后同一份代码突然开始报 curl error 60?
PHP 5.6 是分水岭。据 PHP 官方 UPGRADING 文档,自 5.6 起 cURL 扩展与 openssl 流包装器默认开启对端证书校验(CURLOPT_SSL_VERIFYPEER=true、流上下文 verify_peer=true),5.5 及更早默认不校验。所以老代码从 5.4/5.5 迁到 5.6/7.x/8.x 后立刻抛出 curl: (60) SSL certificate problem: unable to get local issuer certificate,属于预期行为,不是”升级引入的新 bug”。正确修法是补齐 CA 根证书,而不是 curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false) 把验证关掉——后者会让 TLS 退化成只能防误连、不能防中间人。
OpenSSL 版本本身在老系统上会带来哪些额外坑?
除算法套件受限外,更隐蔽的是”根证书库太旧”。仍在跑 CentOS 7(自带 openssl-1.0.2k)的机器,ca-certificates 包常年不更新,很可能不含 ISRG Root X1;Let’s Encrypt 的 DST Root CA X3 于 2021-09-30 到期后,这批环境集体出现 php openssl证书验证失败。同时注意 PHP 8.1 起 curl 扩展要求 libcurl ≥ 7.29.0,PHP 8.0 起 openssl 扩展收紧了对部分老算法/弱密钥的支持,用 1024 位 RSA 或 SHA-1 签名的老内网证书会直接验不过。
| OpenSSL 分支 | 状态 | 停止支持日期 | 典型承载环境 |
|---|---|---|---|
| 1.0.1 | 已 EOL | 2016-12-31 | CentOS 6 |
| 1.0.2 | 已 EOL | 2019-12-31 | CentOS 7、Ubuntu 16.04 |
| 1.1.1 | 已 EOL | 2023-09-11 | Ubuntu 18.04/20.04、Debian 10 |
| 3.0 | LTS | 2026-09-07 | Ubuntu 22.04、Debian 12 |
排查第一步永远是看生效值而不是猜,一条命令同时打印 OpenSSL、libcurl 和两个 CA 配置项:
# 一次看清运行时真实加载的版本与 CA 路径(ini_get 返回空字符串说明该项未显式设置)
php -r 'printf("PHP %snOpenSSL: %snlibcurl: %snopenssl.cafile=[%s]ncurl.cainfo=[%s]n",
PHP_VERSION, OPENSSL_VERSION_TEXT, curl_version()["version"],
ini_get("openssl.cafile"), ini_get("curl.cainfo"));'
# 查看 OpenSSL 扩展自己认为的默认 CA 搜索路径(含文件与目录)
php -r 'print_r(openssl_get_cert_locations());'
Windows 版 PHP 为什么开箱就验证失败?
php.net 的 Windows 官方包不附带 CA 证书包,php.ini 里 curl.cainfo 与 openssl.cafile 默认处于注释状态。必须手动下载 cacert.pem(curl.se/ca/cacert.pem,由 Mozilla 根证书库转换而来)并写绝对路径:
; php.ini —— 两行都要开,缺一不可:curl 用 curl.cainfo,stream/file_get_contents 用 openssl.cafile
curl.cainfo = "C:phpextrassslcacert.pem"
openssl.cafile = "C:phpextrassslcacert.pem"
; 路径必须是绝对路径;用正斜杠 C:/php/extras/ssl/cacert.pem 也可,反斜杠需确认未被转义
macOS 上 Homebrew PHP 的 CA 路径怎么固定?
Homebrew 安装的 PHP 使用 openssl@3 自带的 cert.pem,而不是系统 Keychain,两者并不同步;且 Apple Silicon 与 Intel 路径不同、升级 openssl@3 后路径可能变动,所以应在 php.ini 中显式写死,而不是依赖回退:
# 先确认当前前缀,不要照抄网上路径
brew --prefix openssl@3 # Apple Silicon: /opt/homebrew/opt/openssl@3
# Intel: /usr/local/opt/openssl@3
; php.ini
; Apple Silicon
openssl.cafile = "/opt/homebrew/etc/openssl@3/cert.pem"
curl.cainfo = "/opt/homebrew/etc/openssl@3/cert.pem"
; Intel 机器改为 /usr/local/etc/openssl@3/cert.pem
Docker 官方镜像里 CA 是配好的,为什么还会失败?
据 Docker 官方 php 镜像说明,其基于 Debian,已安装 ca-certificates,OpenSSL 会走 /etc/ssl/certs 目录回退,此时 openssl.cafile 为空是正常的。真正的坑是挂载了自定义 php.ini 并把该项覆盖成空值或错误路径,导致静默回退行为在不同发行版上表现不一致。验证方式:
# 空字符串 = 走系统目录回退;若被自定义 ini 覆盖成错误路径,这里会显示该路径
docker run --rm php:8.3-fpm php -r 'var_dump(ini_get("openssl.cafile"), ini_get("curl.cainfo"));'
# 对比容器内系统 CA 是否齐全
docker run --rm php:8.3-fpm sh -c 'ls -l /etc/ssl/certs/ca-certificates.crt && grep -c "BEGIN CERTIFICATE" /etc/ssl/certs/ca-certificates.crt'
结论性操作原则:无论在哪个平台,都把
openssl.cafile与curl.cainfo显式写成绝对路径并纳入版本管理,把”静默回退系统路径”这个不确定项彻底消除;这是老系统上排查 php openssl证书验证失败 时成本最低、收益最高的一步。
怎么确认修复生效?6 种验证方法
改完 openssl.cafile 或替换了 cacert.pem 之后,最忌讳的是只看 php -i 就宣布搞定。下面 6 种方法从”PHP 读到哪个文件”一路验证到”生产环境持续可用”,建议按顺序全部执行一遍。
- 先确认 PHP 到底在找哪个 CA 文件?用
openssl_get_cert_locations()(PHP 5.4+ 可用)打印 PHP 实际使用的路径,而不是你以为的路径。若输出为MISSING,说明php.ini里的路径写错或指向空占位文件——这是 php openssl证书验证失败 最常见的成因。curl.se 提供的cacert.pem约 220 KB,低于 200 KB 基本可判定为过期或残缺文件。# 打印 PHP 认定的默认 CA 文件路径、是否存在、字节大小 php -r '$l = openssl_get_cert_locations(); var_dump($l["default_cert_file"], is_file($l["default_cert_file"]) ? filesize($l["default_cert_file"]) : "MISSING");' # 期望:string(...) "/etc/ssl/certs/cacert.pem" int(219000+) 左右 # 同时确认加载的是哪个 php.ini(CLI 与 FPM 可能不是同一个) php --ini | grep -i "Loaded Configuration" - 确认 PHP 实际链接的 OpenSSL 版本。如果 PHP 编译时静态链接了自带 OpenSSL,那么你更新系统 CA 库对它毫无影响,必须改
curl.cainfo/openssl.cafile才行。拿curl_version()与系统openssl version对比即可判断。php -r 'var_dump(curl_version()["ssl_version"], OPENSSL_VERSION_TEXT);' # 期望:string(14) "OpenSSL/3.0.13" # string(29) "OpenSSL 3.0.13 30 Jan 2024" openssl version -a # 与上面不一致,说明 PHP 用的是另一套 OpenSSL 运行时 - 发起一次真实 HTTPS 请求(端到端验证)。这一步才是最终判据:证书链、SNI、主机名校验会同时被覆盖。失败时
curl_error()会直接给出 cURL error 60 的原始文案SSL certificate problem: unable to get local issuer certificate。php -r '$c = curl_init("https://www.howsmyssl.com/a/check"); curl_setopt($c, CURLOPT_RETURNTRANSFER, true); var_dump(curl_exec($c) !== false, curl_error($c));' # 通过:bool(true) 与 string(0) "" - 用 openssl s_client 验证证书链本身是否完整。据 OpenSSL 文档,
-verify_return_error会让握手在校验失败时直接中止而不是继续,因此能真实暴露”服务器漏发中间证书”的问题(RFC 5280 第 6 节的路径构建要求终端实体到受信根的完整链)。openssl s_client -connect example.com:443 -servername example.com -CAfile /etc/ssl/certs/cacert.pem -verify_return_error </dev/null # 输出末尾应为:Verify return code: 0 (ok) # OpenSSL 3.x 还会额外打印一行:Verification: OK - 分别验证系统 curl 与 PHP curl。两者可能链接不同 OpenSSL(尤其 Docker 镜像里常见),只测其中一个会漏判。看到
SSL certificate verify ok.即 curl 层通过。curl -vI https://example.com 2>&1 | grep -E "SSL certificate verify|subject:|issuer:" # 期望:SSL certificate verify ok. curl --version | head -1 # 系统 curl 的 OpenSSL php -r 'print_r(curl_version()["version"]);' # PHP curl 的版本号 - 上线后加监控,别等用户报错。用 cron 每天跑一次检测脚本,把剩余天数和验证结果写进 node_exporter 的 textfile collector;剩余小于 14 天或验证失败即告警。可配合
testssl.sh或 Qualys SSL Labs API 做协议/套件层面的补充检查(Let’s Encrypt 官方建议在到期前 30 天完成续期)。#!/usr/bin/env bash # /usr/local/bin/check_ca.sh —— 每日 cron 调用,输出 Prometheus 指标 set -euo pipefail OUT=/var/lib/node_exporter/textfile/ca_check.prom HOST=example.com CA=/etc/ssl/certs/cacert.pem end=$(echo | openssl s_client -connect "$HOST:443" -servername "$HOST" 2>/dev/null | openssl x509 -noout -enddate | cut -d= -f2) left=$(( ( $(date -d "$end" +%s) - $(date +%s) ) / 86400 )) ok=0 echo | openssl s_client -connect "$HOST:443" -servername "$HOST" -CAfile "$CA" -verify_return_error >/dev/null 2>&1 && ok=1 cat > "$OUT" <<EOF tls_cert_days_left{host="$HOST"} $left tls_verify_ok{host="$HOST"} $ok EOF # 对应告警规则(prometheus/rules.yml) # - alert: TLSCertExpiringSoon # expr: tls_cert_days_left < 14 # - alert: TLSVerifyFailing # expr: tls_verify_ok == 0
| 方法 | 检查对象 | 通过判据 | 耗时 |
|---|---|---|---|
openssl_get_cert_locations() |
PHP 配置的 CA 路径与文件完整性 | 路径存在且 > 200 KB | < 1 秒 |
curl_version()["ssl_version"] |
PHP 链接的 OpenSSL 版本 | 与 openssl version 一致 |
< 1 秒 |
| PHP cURL 真实请求 | 端到端握手 + 主机名校验 | bool(true) 且 error 为空 |
1–3 秒 |
s_client -verify_return_error |
服务端证书链完整性 | Verify return code: 0 (ok) |
1 秒 |
系统 curl -vI |
系统 CA 库与 PHP CA 是否一致 | SSL certificate verify ok. |
1 秒 |
| cron + Prometheus 监控 | 长期可用性与到期时间 | 指标持续为 1 且天数 > 14 | 每日一次 |
执行验证前务必先确认生效范围:curl.cainfo 是 PHP_INI_SYSTEM、openssl.cafile 是 PHP_INI_PERDIR,两者都无法用 ini_set() 在运行时覆盖,改完 php.ini 必须 systemctl reload php-fpm(或重启 Apache/mod_php)后再跑上述命令;否则你看到的仍是旧进程里的旧配置,很容易误判为”改了没用”。
长期运维建议:CA 包更新节奏与成本参考
发行版自带的 CA 信任库要多久更新一次?结论是跟随发行版的安全更新即可,不需要单独维护。Debian/Ubuntu 的信任库由 ca-certificates 包提供,产物是 /etc/ssl/certs/ca-certificates.crt;RHEL/CentOS 由 ca-certificates 包提供,产物是 /etc/pki/tls/certs/ca-bundle.crt,更新后需执行 update-ca-trust extract。当出现 php openssl 证书验证失败时,先确认 PHP 实际加载的是哪个文件,而不是凭猜测判断:
# 查看 PHP 的默认 CA 搜索路径与 ini 覆盖情况(openssl.cafile / openssl.capath)
php -r 'var_dump(openssl_get_cert_locations());'
# 输出示例:["default_cert_file"]=>"/usr/lib/ssl/cert.pem" ...
# Debian/Ubuntu:只升级信任库包,避免整机升级
sudo apt-get install --only-upgrade ca-certificates
# RHEL 系
sudo update-ca-trust extract
# 自维护 cacert.pem:建议每 3 个月从 curl.se 拉一次,先备份再替换
cp /usr/local/etc/cacert.pem /usr/local/etc/cacert.pem.bak # 回滚副本
curl -fsSL https://curl.se/ca/cacert.pem -o /tmp/cacert.pem.new
grep -c "BEGIN CERTIFICATE" /tmp/cacert.pem.new # 数量应逐次递增,用于判断是否为完整包
mv /tmp/cacert.pem.new /usr/local/etc/cacert.pem
php -r 'var_dump(openssl_get_cert_locations());' # 确认 openssl.cafile 指向新文件
证书续期节奏怎么定?据 Let’s Encrypt 文档,其证书有效期固定为 90 天,官方建议在剩余约 30 天时续期。certbot 2.x 的 renew 子命令默认隐含 --keep-until-expiring,即剩余有效期大于 30 天时直接跳过,不会重复签发。因此每日定时跑一次 certbot renew 是安全且符合官方推荐的,前提是先用演练模式验证钩子脚本没有坏掉:
certbot renew --dry-run # 走一遍完整流程但不写入证书
systemctl list-timers | grep certbot # Debian 包自带 certbot.timer,无需自建 cron
怎么把 CA 包写进部署清单?Dockerfile 中放进信任库目录后必须执行 update-ca-certificates,且文件名要以 .crt 结尾才会被扫描到;Alpine 基础镜像需要先 apk add ca-certificates,否则连 update-ca-certificates 命令都不存在:
# Dockerfile 片段
COPY cacert.pem /usr/local/share/ca-certificates/internal-ca.crt
RUN update-ca-certificates # 合并生成 /etc/ssl/certs/ca-certificates.crt
K8s 侧用 ConfigMap 挂载(注意单个 ConfigMap 上限 1 MiB,多份大包要拆分),并在启动脚本里做 sha256 自检,避免挂载静默失败后才发现 php openssl 证书验证失败:
# 生成校验文件后与 ConfigMap 一同挂载
sha256sum cacert.pem > cacert.pem.sha256
# 容器启动脚本
sha256sum -c /etc/ssl/custom/cacert.pem.sha256 || exit 1
私有 CA 怎么补吊销机制?PHP 的 SSL 上下文选项里没有 crl_file,OpenSSL 扩展不会自动做 CRL/OCSP 校验,吊销检查必须在应用层显式完成。可用 openssl_x509_checkpurpose() 做链验证(返回 true/false,-1 表示检查过程本身出错),CRL 校验则交给 CLI:
<?php
$ca = '/etc/ssl/private-ca.pem';
$cert = file_get_contents('/etc/ssl/server.pem');
// X509_PURPOSE_SSL_SERVER 会校验用途、有效期与签发链
var_dump(openssl_x509_checkpurpose($cert, X509_PURPOSE_SSL_SERVER, [$ca]));
openssl verify -crl_check -CAfile ca.pem -CRLfile crl.pem server.pem
# 输出 server.pem: OK 表示未吊销且链可信
成本怎么估算?证书本身的费用与监控工具的费用需要分开计算。EV 证书的溢价在 2019 年之后已基本失去可视收益——Chrome 77 与 Firefox 69 起不再在地址栏展示 EV 标识,据 CA/Browser Forum 与各家浏览器厂商的公告,用户只能点开证书详情才能看到组织信息。
| 类型 | 典型年费 | 验证内容 | 浏览器呈现 |
|---|---|---|---|
| DV(含 Let’s Encrypt) | 0–300 元,Let’s Encrypt 为 0 | 仅域名控制权 | 与 OV 一致,Chrome 已移除锁形图标 |
| OV | 800–3000 元 | 组织主体真实性核验 | 需展开证书查看 |
| EV | 3000–10000 元 | 最严格的主体核验 | 2019 年起不再显示绿色标识 |
监控侧:自建脚本(openssl s_client -connect host:443 -servername host </dev/null 2>/dev/null | openssl x509 -noout -enddate 加 cron 比对)成本接近 0 元;第三方证书监控 SaaS 常见 50–200 元/月。若团队没有专人值守,至少配一条“证书剩余 14 天”的告警——这比升级到 EV 更能避免线上事故。
浏览器内置了完整的根证书库,并会通过证书里的 AIA(Authority Information Access)字段自动补全缺失的中间证书,而 OpenSSL 默认不会主动下载 AIA。PHP 侧的信任锚完全取决于 openssl.cafile 或系统 CA 包,所以服务端漏发中间证书时,浏览器能正常访问、PHP 却报 error 60。
设为 false 会关闭对端证书校验,等同于放弃中间人攻击防护,任何能劫持 DNS 或网络的攻击者都能伪造响应。它只适合本地临时调试,生产环境应通过 openssl.cafile 或 CURLOPT_CAINFO 修好信任链,并在代码里显式写出 verify 参数便于审计。
大概率是 php.ini 里的 openssl.cafile 或 curl.cainfo 指向了一个不存在的旧路径,覆盖了系统默认值。执行 php -r 'var_dump(openssl_get_cert_locations());' 看 default_cert_file 实际指向哪里,再决定是改配置还是补文件。
项目本身用 Composer 管理依赖,可以直接用 composer/ca-bundle,它随 composer update 更新,代码里通过 CaBundle::getSystemCaRootBundlePath() 取路径;不用 Composer 或需要跨语言统一 CA 的场景,下载 cacert.pem 写进 php.ini 更直接,也更容易在容器里固化。
error 60 是信任链验证失败,通常是 CA 缺失或证书过期;error 51 是对端证书与目标主机名不匹配,多发生在用 IP 直连,或用 CURLOPT_RESOLVE 后 Host 与 SNI 不一致的场景。前者改 CA 配置,后者改访问地址或 SNI 参数。
这是 OpenSSL 3.x 的新错误码格式,0A000086 对应 SSL_R_CERTIFICATE_VERIFY_FAILED,与 OpenSSL 1.1.1 时代的 1416F086 含义相同。排查方法不变:先看服务端链是否完整,再看 PHP 的 CA 文件是否可用、路径是否正确。
验证失败与证书品牌基本无关,取决于客户端 CA 包是否包含对应根证书。Let's Encrypt 使用 ISRG Root X1(老设备曾依赖 DST Root CA X3 交叉签名,2024-06 后新证书默认不再附带交叉签名),商业 DV 证书根证书更老、兼容性略好,价格约 0-300 元/年,但对现代客户端的验证失败问题没有本质差别。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。