PHP openssl_x509_parse 怎样读取证书有效期和主题信息
来源:17golang原创
时间:2026-11-18 03:09:02 196浏览 收藏
在 PHP 里读取 X.509 证书的主题、签发者和有效期,最直接的入口是 openssl_x509_parse():它把证书解析为数组,常用字段包括 subject、issuer、validFrom 和 validTo。真正需要注意的是返回值可能是 false、键名会受 short_names 影响,而且证书时间同时存在展示字符串和 Unix 时间戳两种形式。
把证书当作不完全稳定的外部数据读取:先判断解析是否成功,再按约定的键名取值;展示用日期字符串,比较和告警用validFrom_time_t、validTo_time_t。
官方地址:https://www.php.net/manual/en/function.openssl-x509-parse.php
本文只讨论从已有 X.509 证书中读取信息,不讨论证书签发、私钥生成、域名校验或 TLS 握手验证。
先把证书解析成 PHP 数组
证书可以来自文件,也可以来自数据库或接口返回的 PEM 字符串。下面的示例以本地 certificate.pem 为例:先读取原文,再调用 openssl_x509_parse(),最后把 false 当作执行失败处理。
官方定义的返回类型是 array|false。因此,不能把解析结果直接标注为“总有数组”,也不要在未判断的情况下写 $parsed['subject']['CN']。证书内容损坏、格式不受支持或 OpenSSL 无法解析时,都应该沿着失败分支返回明确错误。

short_names 决定主题和签发者的键名
openssl_x509_parse() 的第二个参数 short_names 默认是 true。此时主题里的通用名称通常以 CN 表示,组织和组织单位则可能以 O、OU 表示;传入 false 后,键名使用 commonName、organizationName、organizationalUnitName 这样的长名称。
两种模式不是两份不同的证书数据,而是同一类字段的命名方式不同。新代码可以选择长键来提高可读性;如果项目已有短键数据结构,就不要只改一个调用点,否则不同证书摘要会出现键名混用。
有效期要区分展示值和比较值
解析结果通常同时提供 validFrom、validTo 这样的证书时间文本,以及 validFrom_time_t、validTo_time_t 这样的 Unix 时间戳。页面展示可以使用前者,判断“是否已经过期”或“距离到期还有多少秒”时应优先使用后者。
$validToTimestamp ? '已过期' : '有效');
echo sprintf('%s:%s 至 %s', $status, $validFrom, $validTo);
?>
不要直接比较未统一时区和格式的日期字符串,也不要把时间戳字段缺失当成永久有效。到期提醒可以基于 $validToTimestamp - time() 计算剩余秒数,并给负数、缺失字段和异常证书单独记录状态。

把可选字段读取封装成证书摘要
证书的 extensions、purposes、主题字段并不适合用“每一张证书都有固定完整结构”的方式读取。官方手册明确提醒,解析数组的具体结构可能变化,所以更稳妥的是只提取业务真正需要的字段,并使用空合并和类型判断。
$subject['commonName'] ?? null,
'issuer_common_name' => $issuer['commonName'] ?? null,
'valid_from' => $data['validFrom'] ?? null,
'valid_to' => $data['validTo'] ?? null,
'valid_from_timestamp' => is_int($data['validFrom_time_t'] ?? null)
? $data['validFrom_time_t']
: null,
'valid_to_timestamp' => is_int($data['validTo_time_t'] ?? null)
? $data['validTo_time_t']
: null,
];
}
?>
这个摘要函数故意没有把完整解析数组直接返回给前端或日志系统:只保留业务需要的字段,减少对 OpenSSL 返回结构的耦合。若还需要读取扩展,应先判断 $data['extensions'] 是否为数组,再按已确认的扩展名读取。
版本和错误处理要留出余量
PHP 手册显示,PHP 8.0 起证书参数可以接受 OpenSSLCertificate 对象;更早版本常见的是资源类型。PHP 8.4 对没有秒数的 UTCTime 解析也收紧了要求。实际升级时,不要只在本地 PHP 版本上查看“能否读出数组”,还要准备一张包含边界时间格式的证书样本,并记录解析失败的原因。
同时要记住,openssl_x509_parse() 只负责解析证书信息。它不会替代主机名匹配、证书链验证或公钥用途检查。如果业务目标是判断 HTTPS 连接是否可信,还需要使用适合该目标的 TLS 校验流程。
常见问题
为什么读不到 subject['CN']?
先确认第二个参数是否为 true,再检查证书主题是否真的含有通用名称。若调用时使用了 false,应读取 subject['commonName'];若字段本身不存在,就应按缺失处理,而不是强行补一个空字符串。
validFrom 和 validFrom_time_t 应该用哪个?
面向读者展示时可以保留 validFrom;做过期判断、排序和提醒时使用 validFrom_time_t。两者都缺失时,应把证书标记为无法判断,而不是默认为当前时间。
解析成功是不是代表证书可信?
不是。解析成功只说明 PHP 能读取证书结构;证书链、签名、用途、主机名和撤销状态仍需由相应的验证流程负责。
总结
用 PHP openssl_x509_parse() 读取证书信息时,可以按这条路径处理:先判断返回值,再固定 short_names 约定;从 subject 和 issuer 读取身份字段;用 validFrom/validTo 做展示,用时间戳做比较;最后只提取业务需要的摘要字段。这样既能覆盖常见证书信息,也能把 OpenSSL 返回结构的变化隔离在一个小函数里。
-
371 收藏
-
245 收藏
-
347 收藏
-
112 收藏
-
Golang · Go教程 | 3个月前 | golang · https · TLS · Go教程 · 生产运维 · atomic.Value Go HTTPS证书热切换 GetCertificate tls.Certificate 证书轮换267 收藏
-
333 收藏
-
242 收藏
-
106 收藏
-
299 收藏
-
198 收藏
-
351 收藏
-
112 收藏
-
498 收藏
-
447 收藏
-
170 收藏
-
408 收藏
-
303 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习