ldap_set_option

ldap_set_option -- Modifie la valeur d'une option LDAP

Description

bool ldap_set_option ( resource link_identifier, int option, mixed newval)

ldap_set_option modifie la valeur de l ' option option en remplacant la valeur courante par newval . Cette fonction retourne TRUE en cas de succès , FALSE en cas d ' échec. .

Le paramètre option Le paramètre option peut prendre l ' une des valeurs suivantes : Voici une brève description des valeurs ci-dessus , dans le fichier draft-ietf-ldapext-ldap-c-api-xx.txt .

Les options LDAP_OPT_DEREF , LDAP_OPT_SIZELIMIT , LDAP_OPT_TIMELIMIT , LDAP_OPT_PROTOCOL_VERSION et LDAP_OPT_ERROR_NUMBER doivent être des entiers , LDAP_OPT_REFERRALS et LDAP_OPT_RESTART doivent être des booléens , et LDAP_OPT_HOST_NAME , LDAP_OPT_ERROR_STRING et LDAP_OPT_MATCHED_DN doivent être des chaînes . Le premier exemple illustre leur utilisation . Les options LDAP_OPT_SERVER_CONTROLS et LDAP_OPT_CLIENT_CONTROLS requièrent une liste de contrôles , ce qui signifie que la valeur doit être un tableau de contrôles . Un contrôle est constitués d' un oid identifiant le contrôle , une valeur optionnelle value , et un flag optionnel de criticalité ( criticality ) . En PHP , un contrôle est définit sous la forme d ' un tableau , donc les clés sont oid avec une chaîne comme valeur , et deux clés optionnelles . Ces clés sont value avec une chaîne comem valeur , et iscritical avec une valeur booléenne . Par défaut , iscritical vaut FALSE . Reportez vous au second exemple pour une illustration .

Cette fonction n ' est disponible que lorsque vous utilisez OpenLDAP 2.x.x ou Netscape Directory SDK x.x . Elle a été ajoutée en PHP 4.0.4 .

Exemple 1 .

 
?php

 
/

 
/

 
$ds

 
doit

 
ecirc;

 
tre

 
une

 
ressource

 
de

 
connexion

 
valide

 
if

 
(ldap_set_option($ds

 
,

 
LDAP_OPT_PROTOCOL_VERSION

 
,

 
3)

 
)

 
echo

 
"Version

 
LDAPv3"

 
;

 
else

 
echo

 
"Impossible

 
de

 
modifier

 
la

 
version

 
du

 
protocole

 
agrave

 
;

 
3"

 
;

 
?



Exemple 2 .

 
/

 
/

 
$ds

 
doit

 
ecirc;

 
tre

 
une

 
ressource

 
de

 
connexion

 
valide

 
/

 
/

 
controle

 
sans

 
valeur

 
$ctrl1

 
=

 
array("oid

 
"

 
=

 
"1.2.752.58.10.1"

 
,

 
"iscritical

 
"

 
=

 
TRUE)

 
;

 
/

 
/

 
iscritical

 
vaut

 
par

 
d

 
eacute;faut

 
FALSE

 
$ctrl2

 
=

 
array("oid

 
"

 
=

 
"1.2.752.58.1.10"

 
,

 
"value

 
"

 
=

 
"magic")

 
;

 
/

 
/

 
essayez

 
d'utiliser

 
les

 
deux

 
contr

 
ocirc;les

 
if

 
(!ldap_set_option($ds

 
,

 
LDAP_OPT_SERVER_CONTROLS

 
,

 
array($ctrl1

 
,

 
$ctrl2))

 
)

 
echo

 
"Impossible

 
de

 
modifier

 
les

 
contr

 
ocirc;les

 
du

 
serveur"

 
;





Voir aussi ldap_get_option( ) .