(PHP 4 >= 4.0.4, PHP 5)
ldap_set_option — Setzt den Wert der gegebenen Option
Setzt den Wert der bestimmten Option auf
neuerwert.Gibt bei Erfolg TRUE zurück. Im Fehlerfall wird FALSE zurückgegeben.
Der Parameter option kann einer der
folgenden sein:
LDAP_OPT_DEREF, LDAP_OPT_SIZELIMIT, LDAP_OPT_TIMELIMIT,
LDAP_OPT_PROTOCOL_VERSION, LDAP_OPT_ERROR_NUMBER,
LDAP_OPT_REFERRALS,
LDAP_OPT_RESTART, LDAP_OPT_HOST_NAME, LDAP_OPT_ERROR_STRING,
LDAP_OPT_MATCHED_DN, LDAP_OPT_SERVER_CONTROLS,
LDAP_OPT_CLIENT_CONTROLS.
Hier eine kurze Beschreibung, schauen Sie unter
» draft-ietf-ldapext-ldap-c-
api-xx.txt nach Details.
Die Optionen LDAP_OPT_DEREF, LDAP_OPT_SIZELIMIT,
LDAP_OPT_TIMELIMIT, LDAP_OPT_PROTOCOL_VERSION und
LDAP_OPT_ERROR_NUMBER haben einen ganzzahligen Wert,
LDAP_OPT_REFERRALS und LDAP_OPT_RESTART haben einen boolschen
Wert und die Optionen LDAP_OPT_HOST_NAME, LDAP_OPT_ERROR_STRING
und LDAP_OPT_MATCHED_DN bestehen aus einer Zeichenkette.
Das erste Beispiel veranschaulicht deren Gebrauch. Die Optionen
LDAP_OPT_SERVER_CONTROLS and LDAP_OPT_CLIENT_CONTROLS benötigen
eine Kontrolliste, d.h. der Wert muss ein Array aus Kontrollen
sein. Eine Kontrolle besteht aus einer oid
die die Kontrolle identifiziert, einem wahlweisen
wert, und einem wahlweisen Kennzeichen für
criticality. Bei PHP wird eine Kontrolle durch ein
Array angegeben. Dieses Array enthält ein Element mit dem
Schlüssel oid und einer Zeichenkette als
Wert und zwei optionalen Elementen. Die optionalen Elemente sind
Schlüssel wert mit einer Zeichenkette als
Wert und dem Schlüssel iscritical mit einem
boolschen Wert. Der vorgegebene Wert von
iscritical ist FALSE falls Sie
nichts angeben.
Schauen Sie sich das zweite Beispiel weiter unten an.
Hinweis:
Diese Funktion steht nur zur Verfügung, wenn Sie OpenLDAP 2.x.x ODER Netscape Directory SDK x.x verwenden und wurde in PHP 4.0.4 hinzugefügt.
Beispiel #1 Setzen der Protokollversion
// $ds ist eine gültige Verbindungs-Kennung für einen Verzeichnis-
// Server
if (ldap_set_option($ds, LDAP_OPT_PROTOCOL_VERSION, 3))
echo "Verwenden von LDAPv3";
else
echo "Kann das Protokoll nicht auf Version 3 setzen";
Beispiel #2 Setzen der Server Kontrollen
// $ds ist eine gültige Verbingund-Kennung für einen Verzeichnis-
// Server
// Kontrolle ohne Wert
$ctrl1 = array("oid" => "1.2.752.58.10.1", "iscritical" => TRUE);
// iscritical hat den vorgegebenen Wert FALSE
$ctrl2 = array("oid" => "1.2.752.58.1.10", "value" => "magic");
// Versuch, beide Kontrollen zu setzen
if (!ldap_set_option($ds, LDAP_OPT_SERVER_CONTROLS, array($ctrl1,
$ctrl2)))
echo "Kann die Server Kontrollen nicht setzen";
Siehe auch ldap_get_option().