ldap_search
<<<		 ldap_set_option ldap_set_rebind_proc
>>>
6.16 LDAP
6 Référence des fonctions
 Manuel PHP
. Introduction
. Pré-requis
. Installation
. Configuration à l'exécution
. Types de ressources
. Constantes pré-définies
. 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_sasl_bind
. ldap_search
->ldap_set_option
. ldap_set_rebind_proc
. ldap_sort
. ldap_start_tls
. ldap_t61_to_8859
. ldap_unbind

6.16.46 ldap_set_option()Modifie la valeur d'une option LDAP

[ Exemples avec ldap_set_option ]   PHP 4 >= 4.0.4, PHP 5

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

ldap_set_option modifie la valeur de l'option option en remplaçant 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é d'un oid l'identifiant, une valeur optionnelle value , et un flag optionnel de "criticalité" ( criticality ). En PHP, un contrôle est défini 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 comme 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.

Modification de la version du protocole

<?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';
}
?>
Modification des contrôles du serveur

<?php
// $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 .

<< ldap_set_option >>
ldap_search LDAP ldap_set_rebind_proc