登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  文章 >  php教程

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 无法解析时,都应该沿着失败分支返回明确错误。

X.509证书经过openssl_x509_parse转换为主题签发者有效期和扩展字段的静态流程说明图
图1:从证书原文到解析字段的静态流程说明图;这是原创说明图,不是终端或运行截图。

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() 计算剩余秒数,并给负数、缺失字段和异常证书单独记录状态。

short_names短键长键映射以及validFrom和validTo时间字段关系的静态说明图
图2:键名映射与证书有效期字段关系说明图;这是原创结构图,不是 PHP 输出截图。

把可选字段读取封装成证书摘要

证书的 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 返回结构的变化隔离在一个小函数里。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>