ldap_get_values
(PHP 4, PHP 5)
ldap_get_values — Lit toutes les valeurs d'une entr�e LDAP
Description
Lit toutes les valeurs de l'attribut d'une entr�e dans un r�sultat.
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.
Liste de param�tres
- link_identifier
-
Un identifiant de lien LDAP, retourn� par la fonction ldap_connect().
- result_entry_identifier
-
- attribute
-
Valeurs de retour
Retourne un tableau de valeurs pour l'attribut, ou FALSE en cas d'erreur. 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.
LDAP permet plus d'une entr�e par attribut, ce qui permet de stocker plusieurs adresses emails par personne, tout en n'utilisant qu'une �tiquette "mail" :
return_value["count"] = nombre de valeurs de l'attribut return_value[0] = premi�re valeur de l'attribut return_value[i] = i-i�me valeur de l'attribut
Exemples
Exemple #1 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 />";
}
?>