ldap_get_values

(PHP 3, PHP 4 , PHP 5)

ldap_get_values -- Lit toutes les valeurs d'une entrée LDAP

Description

array ldap_get_values ( resource link_identifier, resource result_entry_identifier, string attribute )

ldap_get_values() retourne un tableau de valeurs pour l'attribut attribute, ou FALSE en cas d'erreur.

ldap_get_values() sert à lire toutes les valeurs de l'attibut attribute, dans l'entrée courante du résultat de recherche result_entry_identifier, pour la connexion link_identifier. Le nombre de valeurs retournées est disponible à l'index 'count' du tableau retourné. Les valeurs sont accessibles individuellement, avec les index numériques du tableau. L'indexation commence à 0.

L'utilisation de la fonction result_entry_identifier requiert un résultat de recherche, et doit donc être précédée d'une recherche LDAP, et de l'une des fonctions permettant d'accéder à une entrée.

Votre application doit contenir des informations permettant de lire certains attributs (comme "nom" ou "mail"), ou bien vous devrez utiliser la fonction ldap_get_attributes() pour savoir quels sont les attributs qui existent pour une entrée donnée.

LDAP permet plus d'une entrée par attribut, ce qui permet de stocker plusieurs addresse emails par personne, tout en n'utilisant qu'une étiquette "mail" :

Exemple 1. Structure du tableau retourné par ldap_get_values()

return_value["count"] = nombre de valeurs de l'attribut
return_value[0] = première valeur de l'attribut
return_value[i] = n-ième valeur de l'attribut

Exemple 2. Liste toutes les valeurs de l'attribut "mail" d'une entrée

<?php
// $ds doit être une ressource de connexion valide

// $sr doit être une ressource de résultat valide, obtenue avec une des fonctions de
//     recherche LDAP.

// $entry est une entrée LDAP valide, obtenue avec une des fonctions
//        LDAP qui retourne une entrée

$values = ldap_get_values($ds, $entry,"mail");

echo
$values["count"] . " adresses email pour cette entrée.<br />";

for (
$i=0; $i < $values["count"]; $i++) {
    echo
$values[$i] . "<br />";
}
?>