array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.ldap-exop.php', 1 => 'ldap_exop', 2 => 'Effectue une opération étendue', ), 'up' => array ( 0 => 'ref.ldap.php', 1 => 'Fonctions LDAP', ), 'prev' => array ( 0 => 'function.ldap-escape.php', 1 => 'ldap_escape', ), 'next' => array ( 0 => 'function.ldap-exop-passwd.php', 1 => 'ldap_exop_passwd', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/ldap/functions/ldap-exop.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

ldap_exop

(PHP 7 >= 7.2.0, PHP 8)

ldap_exop — Effectue une opération étendue

Description

ldap_exop(
    LDAP\Connection $ldap,
    string $request_oid,
    string $request_data = null,
    array $controls = null,
    string &$response_data = ?,
    string &$response_oid = ?
): mixed

Effectue une opération étendue sur le ldap spécifié avec request_oid l'OID de l'opération et request_data les données.

Liste de paramètres

ldap

Une instance LDAP\Connection, retourné par ldap_connect().

request_oid

L'OID de l'opération étendue. Il est possible d'utiliser LDAP_EXOP_START_TLS, LDAP_EXOP_MODIFY_PASSWD, LDAP_EXOP_REFRESH, LDAP_EXOP_WHO_AM_I, LDAP_EXOP_TURN, ou une chaîne avec l'OID de l'opération qu'on souhaite envoyer.

request_data

L'opération étendue demande des données. Peut être NULL pour certaines opérations comme LDAP_EXOP_WHO_AM_I, peut également nécessiter un encodage BER.

controls

Un tableau de contrôles LDAP à envoyer avec la demande.

response_data

Va être rempli avec les données de réponse de l'opération étendue si fournies. Si non fournies, il est possible d'utiliser ldap_parse_exop sur l'objet résultat plus tard pour obtenir ces données.

response_oid

Va être rempli avec l'OID de réponse si fourni, généralement égal à l'OID de la demande.

Valeurs de retour

Lorsqu'utilisée avec response_data, renvoie true en cas de succès ou false en cas d'erreur. Lorsqu'utilisée sans response_data, renvoie un identifiant de résultat ou false en cas d'erreur.

Historique

Version Description
8.1.0 Le paramètre ldap attend désormais une instance de LDAP\Connection ; auparavant, une resource ldap link était attendue.
7.3.0 Le support de controls a été ajouté

Exemples

Exemple #1 Opération étendue WHOAMI

<?php
$ds = ldap_connect("localhost"); // assumant que le serveur LDAP est sur cet hôte
if ($ds) {
// lie avec le dn approprié pour donner l'accès de mise à jour
$bind = ldap_bind($ds, "cn=root, o=My Company, c=US", "secret");
if (!$bind) {
echo "Unable to bind to LDAP server";
exit;
}
// Appel de l'opération étendue WHOAMI
$r = ldap_exop($ds, LDAP_EXOP_WHO_AM_I);
// analyse l'objet résultat
ldap_parse_exop($ds, $r, $retdata);
// Output: string(31) "dn:cn=root, o=My Company, c=US"
var_dump($retdata);
// Même chose en utilisant le paramètre $response_data
$success = ldap_exop($ds, LDAP_EXOP_WHO_AM_I, NULL, NULL, $retdata, $retoid);
if ($success) {
var_dump($retdata);
}
ldap_close($ds);
} else {
echo "Unable to connect to LDAP server";
}
?>

Voir aussi