array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'zh', ), 'this' => array ( 0 => 'function.openssl-x509-checkpurpose.php', 1 => 'openssl_x509_checkpurpose', 2 => '验证是否可以为特定目的使用证书', ), 'up' => array ( 0 => 'ref.openssl.php', 1 => 'OpenSSL 函数', ), 'prev' => array ( 0 => 'function.openssl-x509-check-private-key.php', 1 => 'openssl_x509_check_private_key', ), 'next' => array ( 0 => 'function.openssl-x509-export.php', 1 => 'openssl_x509_export', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'zh', 'path' => 'reference/openssl/functions/openssl-x509-checkpurpose.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

openssl_x509_checkpurpose

(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)

openssl_x509_checkpurpose — 验证是否可以为特定目的使用证书

说明

openssl_x509_checkpurpose(
    OpenSSLCertificate|string $certificate,
    int $purpose,
    array $ca_info = [],
    ?string $untrusted_certificates_file = null
): bool|int

openssl_x509_checkpurpose() 检查证书以查看它是否可用于指定目的 purpose。

参数

certificate

被检查的证书。

purpose

openssl_x509_checkpurpose() 目的
常量名 描述
X509_PURPOSE_SSL_CLIENT 证书是否可以用于 SSL 连接的客户端?
X509_PURPOSE_SSL_SERVER 证书是否可以用于 SSL 连接的服务器端?
X509_PURPOSE_NS_SSL_SERVER 证书是否可以用于 Netscape SSL 服务器?
X509_PURPOSE_SMIME_SIGN 证书是否可以用来签名 S/MIME 邮件?
X509_PURPOSE_SMIME_ENCRYPT 正式是否可用用来加密 S/MIME 邮件?
X509_PURPOSE_CRL_SIGN 证书是否可以用来签名证书撤销列表（CRL）?
X509_PURPOSE_ANY 证书是否可以用于任何目的?
这些选项不是位字段——只能指定一个字段!

ca_info

ca_info 应该是一个受信任的 CA 文件/文件夹组成的数组，如 Certificate Verification 所描述的一样。

untrusted_certificates_file

如果指定，这应该是 PEM 编码文件的名称，该文件持有证书，可以用来帮助验证证书,尽管从该文件中获得的证书不受信任。

返回值

如果证书可以用于预期目的，返回 true，如果不行，则返回 false 错误便会返回 -1。

更新日志

版本 说明
8.0.0 certificate 现在接受 OpenSSLCertificate 实例；之前接受类型 OpenSSL X.509 的 resource。
8.0.0 untrusted_certificates_file 现在可为 null。