Rechercher une fonction PHP

ldap_set_option

(PHP 4 >= 4.0.4, PHP 5, PHP 7)

ldap_set_optionModifie la valeur d'une option LDAP

Description

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

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 option peut prendre l'une des valeurs suivantes :

Option Type Disponible depuis
LDAP_OPT_DEREF entier  
LDAP_OPT_SIZELIMIT entier  
LDAP_OPT_TIMELIMIT entier  
LDAP_OPT_NETWORK_TIMEOUT entier PHP 5.3.0
LDAP_OPT_PROTOCOL_VERSION entier  
LDAP_OPT_ERROR_NUMBER entier  
LDAP_OPT_REFERRALS booléen  
LDAP_OPT_RESTART booléen  
LDAP_OPT_HOST_NAME chaîne de caractères  
LDAP_OPT_ERROR_STRING chaîne de caractères  
LDAP_OPT_DIAGNOSTIC_MESSAGE string  
LDAP_OPT_MATCHED_DN chaîne de caractères  
LDAP_OPT_SERVER_CONTROLS tableau  
LDAP_OPT_CLIENT_CONTROLS tableau  
LDAP_OPT_X_KEEPALIVE_IDLE entier PHP 7.1.0
LDAP_OPT_X_KEEPALIVE_PROBES entier PHP 7.1.0
LDAP_OPT_X_KEEPALIVE_INTERVAL entier PHP 7.1.0
LDAP_OPT_X_TLS_CACERTDIR chaîne de caractères PHP 7.1.0
LDAP_OPT_X_TLS_CACERTFILE chaîne de caractères PHP 7.1.0
LDAP_OPT_X_TLS_CERTFILE chaîne de caractères PHP 7.1.0
LDAP_OPT_X_TLS_CIPHER_SUITE chaîne de caractères PHP 7.1.0
LDAP_OPT_X_TLS_CRLCHECK entier PHP 7.1.0
LDAP_OPT_X_TLS_CRLFILE chaîne de caractères PHP 7.1.0
LDAP_OPT_X_TLS_DHFILE chaîne de caractères PHP 7.1.0
LDAP_OPT_X_TLS_KEYILE chaîne de caractères PHP 7.1.0
LDAP_OPT_X_TLS_PROTOCOL_MIN entier PHP 7.1.0
LDAP_OPT_X_TLS_RANDOM_FILE chaîne de caractères PHP 7.1.0
LDAP_OPT_X_TLS_REQUIRE_CERT entier PHP 7.0.5

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. 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 option spécifiée.

  

Valeurs de retour

Cette fonction retourne TRUE en cas de succès ou FALSE si une erreur survient.

  

Exemples

Exemple #1 Modification de la version du protocole

<?php
// $ds doit être une ressource de connexion valide
if (ldap_set_option($dsLDAP_OPT_PROTOCOL_VERSION3)) {
    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($dsLDAP_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.

  

Voir aussi

Rechercher une fonction PHP

Version en cache

23/12/2024 04:17:03 Cette version de la page est en cache (à la date du 23/12/2024 04:17:03) afin d'accélérer le traitement. Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la dernère version de la page.

Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-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

  1. Consulter le document html Langue du document :fr Manuel PHP : http://php.net

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.

Table des matières Haut