ldap_set_option
(PHP 4 >= 4.0.4, PHP 5, PHP 7)
ldap_set_option — Modifie la valeur d'une option LDAP
Description
Modifie la valeur de l'option option en remplaçant la valeur
courante par newval.
Liste de paramètres
-
link_identifier -
Un identifiant de lien LDAP, retourné par la fonction ldap_connect().
-
option -
Le paramètre
optionpeut prendre l'une des valeurs suivantes :Option Type Disponible depuis LDAP_OPT_DEREFentier LDAP_OPT_SIZELIMITentier LDAP_OPT_TIMELIMITentier LDAP_OPT_NETWORK_TIMEOUTentier PHP 5.3.0 LDAP_OPT_PROTOCOL_VERSIONentier LDAP_OPT_ERROR_NUMBERentier LDAP_OPT_REFERRALSbooléen LDAP_OPT_RESTARTbooléen LDAP_OPT_HOST_NAMEchaîne de caractères LDAP_OPT_ERROR_STRINGchaîne de caractères LDAP_OPT_DIAGNOSTIC_MESSAGEstring LDAP_OPT_MATCHED_DNchaîne de caractères LDAP_OPT_SERVER_CONTROLStableau LDAP_OPT_CLIENT_CONTROLStableau LDAP_OPT_X_KEEPALIVE_IDLEentier PHP 7.1.0 LDAP_OPT_X_KEEPALIVE_PROBESentier PHP 7.1.0 LDAP_OPT_X_KEEPALIVE_INTERVALentier PHP 7.1.0 LDAP_OPT_X_TLS_CACERTDIRchaîne de caractères PHP 7.1.0 LDAP_OPT_X_TLS_CACERTFILEchaîne de caractères PHP 7.1.0 LDAP_OPT_X_TLS_CERTFILEchaîne de caractères PHP 7.1.0 LDAP_OPT_X_TLS_CIPHER_SUITEchaîne de caractères PHP 7.1.0 LDAP_OPT_X_TLS_CRLCHECKentier PHP 7.1.0 LDAP_OPT_X_TLS_CRLFILEchaîne de caractères PHP 7.1.0 LDAP_OPT_X_TLS_DHFILEchaîne de caractères PHP 7.1.0 LDAP_OPT_X_TLS_KEYILEchaîne de caractères PHP 7.1.0 LDAP_OPT_X_TLS_PROTOCOL_MINentier PHP 7.1.0 LDAP_OPT_X_TLS_RANDOM_FILEchaîne de caractères PHP 7.1.0 LDAP_OPT_X_TLS_REQUIRE_CERTentier PHP 7.0.5 Les options
LDAP_OPT_SERVER_CONTROLSetLDAP_OPT_CLIENT_CONTROLSrequiè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 vautFALSE. Voir le fichier » draft-ietf-ldapext-ldap-c-api-xx.txt pour plus de détails. Reportez-vous au second exemple pour une illustration. -
newval -
La nouvelle valeur pour l'option
optionspécifiée.
Exemples
Exemple #1 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";
}
?>
Exemple #2 Modification des contrôles du serveur
<?php
// $ds doit être une ressource de connexion valide de
// contrôle 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");
// tente 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";
}
?>
Notes
Note:
Cette fonction n'est disponible que lorsque vous utilisez OpenLDAP 2.x.x ou Netscape Directory SDK x.x.
Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-function.ldap-set-option.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.
