ldap_set_option

ldap_set_option -- Setzt den Wert der gegebenen Option

Beschreibung

bool ldap_set_option ( resource Verbindungs-Kennung, int option, mixed neuerwert)

Setzt den Wert der bestimmten Option auf neuerwert .Gibt bei Erfolg TRUE zurück , im Fehlerfall FALSE .

Der Parameter option Der Parameter option kann einer der folgenden sein : 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 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 .

Anmerkung : 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( ) .