<META HREF="function.openssl-x509-export-to-file.html"><META

Beschreibung

bool openssl_x509_checkpurpose ( mixed x509cert, int purpose, array cainfo [, string untrustedfile])

Warnung

Diese Funktion ist EXPERIMENTELL. Das Verhalten, der Funktionsname und alles Andere was hier dokumentiert ist, kann sich in zukünftigen PHP-Versionen ohne Ankündigung ändern. Seien Sie gewarnt und verwenden Sie diese Funktion auf eigenes Risiko.

Kann das Zertifikat für den beabsichtigten Zweck benutzt werden, gibt diese Funktion TRUE zurück; falls nicht FALSE, bei einem Fehler -1.

Die Funktion openssl_x509_checkpurpose() untersucht das mit dem Parameter x509cert angegebene Zertifikat darauf, ob es für den mit purpose angegebenen Zweck benutzt werden kann.

Der Parameter cainfo sollte ein Array aus vertrauenswürdigen CA Dateien/Verzeichnissen enthalten. Dieses Array ist genauer beschrieben unter Zertifikat Nachweis.

Der Parameter untrustedfile, falls angegeben, ist der Name einer PEM verschlüsselten Datei, die Zertifikate enthält, die dazu benutzt werden können, das Zertifikat zu überprüfen, obwohl kein Vertrauen zu diesen Zertifikaten besteht, die aus dieser Datei stammen.

Tabelle 1. openssl_x509_checkpurpose() Zweck

Konstante	Beschreibung
X509_PURPOSE_SSL_CLIENT	Client-Seite einer SSL Verbindung?
X509_PURPOSE_SSL_SERVER	Server-Seite einer SSL Verbindung?
X509_PURPOSE_NS_SSL_SERVER	Netscape SSL Server?
X509_PURPOSE_SMIME_SIGN	Unterschreiben einer S/MIME Email?
X509_PURPOSE_SMIME_ENCRYPT	Verschlüsseln einer S/MIME Email?
X509_PURPOSE_CRL_SIGN	Unterschreiben einer Zertifikats-Widerrufliste(CRL)?
X509_PURPOSE_ANY	Beliebige/alle Zwecke?

Diese Optionen sind keine Bitfelder - Sie können nur eine einzige angeben!

Anmerkung: Diese Funktion wurde in 4.0.6 hinzugefügt.