(PHP 4 >= 4.0.6)openssl_x509_checkpurpose -- Verifies if a certificate can be used for a particular purpose
Descriptionbool openssl_x509_checkpurpose ( mixed x509cert, int purpose, array cainfo [, string untrustedfile])
Returns TRUE if the certificate can be used for the intended purpose, FALSE if it cannot, or -1 on error.
openssl_x509_checkpurpose() examines the certificate specified by x509cert to see if it can be used for the purpose specified by purpose.
cainfo should be an array of trusted CA files/dirs as described in Certificate Verification.
untrustedfile, if specified, is the name of a PEM encoded file holding certificates that can be used to help verify the certificate, although no trust in placed in the certificates that come from that file.
Table 1. openssl_x509_checkpurpose() purposes
|X509_PURPOSE_SSL_CLIENT||Can the certificate be used for the client side of an SSL connection?|
|X509_PURPOSE_SSL_SERVER||Can the certificate be used for the server side of an SSL connection?|
|X509_PURPOSE_NS_SSL_SERVER||Can the cert be used for Netscape SSL server?|
|X509_PURPOSE_SMIME_SIGN||Can the cert be used to sign S/MIME email?|
|X509_PURPOSE_SMIME_ENCRYPT||Can the cert be used to encrypt S/MIME email?|
|X509_PURPOSE_CRL_SIGN||Can the cert be used to sign a certificate revocation list (CRL)?|
|X509_PURPOSE_ANY||Can the cert be used for Any/All purposes?|
Note: This function was added in 4.0.6.