ldap_exop

(PHP 7 >= 7.2.0, PHP 8)

ldap_exop — Effectue une opération étendue

Description

function 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.

Avertissement

L'utilisation de plus de 4 paramètres est obsolète, utiliser ldap_exop_sync() à la place.

Liste de paramètres

ldap
Une instance LDAP\Connection, retourné par ldap_connect().
request_oid
L'OID de la requête d'opération étendue. Peut être l'une des constantes LDAP_EXOP_*, ou une chaîne contenant l'OID de l'opération.
request_data
Les données de la requête d'opération étendue. 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 requête.
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 requête.

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.4.0 L'utilisation de plus de 4 paramètres est obsolète, utiliser ldap_exop_sync() à la place.
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