7.47 LDAP
7 Index des fonctions
Manuel PHP
. Introduction
. Pré-requis
. Installation
. Configuration à l'exécution
. Types de ressources
. Constantes prédefinies
. Exemples
. Utiliser les fonctions LDAP de PHP
. ldap_8859_to_t61
. ldap_add
. ldap_bind
. ldap_close
. ldap_compare
. ldap_connect
. ldap_count_entries
. ldap_delete
. ldap_dn2ufn
. ldap_err2str
. ldap_errno
. ldap_error
. ldap_explode_dn
. ldap_first_attribute
. ldap_first_entry
. ldap_first_reference
. ldap_free_result
. ldap_get_attributes
. ldap_get_dn
. ldap_get_entries
. ldap_get_option
. ldap_get_values_len
. ldap_get_values
. ldap_list
. ldap_mod_add
. ldap_mod_del
. ldap_mod_replace
. ldap_modify
. ldap_next_attribute
. ldap_next_entry
. ldap_next_reference
. ldap_parse_reference
. ldap_parse_result
. ldap_read
. ldap_rename
. ldap_search
->ldap_set_option
. ldap_set_rebind_proc
. ldap_sort
. ldap_start_tls
. ldap_t61_to_8859
. ldap_unbind
|
7.47.45 ldap_set_option()Modifie la valeur d'une option LDAP[ Exemples avec ldap_set_option ] PHP 4 >= 4.0.4
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
peut prendre l'une des valeurs suivantes :
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.
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.
| Note | |
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.
|
| Set protocol version |
<?php
// $ds doit ê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 à 3";
?>
|
| Set server controls |
// $ds doit être une ressource de connexion valide
// controle sans valeur
$ctrl1 = array("oid" => "1.2.752.58.10.1", "iscritical" => TRUE);
// iscritical vaut par défaut FALSE
$ctrl2 = array("oid" => "1.2.752.58.1.10", "value" => "magic");
// essayez d'utiliser les deux contrôles
if (!ldap_set_option($ds, LDAP_OPT_SERVER_CONTROLS, array($ctrl1, $ctrl2)))
echo "Impossible de modifier les contrôles du serveur";
|
Voir aussi
ldap_get_option
.
|
