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