Manuel PHP

Précédent

 

Suivant

ldap_get_values

ldap_get_values -- Retourne toutes les entrées d'un résultat

Description

array ldap_get_values(int link_identifier, int result_entry_identifier, string attribute);

Retourne un tableau de valeurs en cas de succès, et false sinon..

ldap_get_values() sert à lire toutes les valeurs d'un attribut dans une entrée. L'entrée est référencée par result_entry_identifier. Le nombre de valeurs peut être trouvé à l'index "count" dans le résultat. Les valeurs sont accessibles par un index entier, qui commence à 0.

Cette fonction nécessite un pointeur de résultat result_entry_identifier, ce qui implique qu'il ai été précédé d'une recherche sur le serveur, et de l'obtention d'une entrée.

Votre application pourra utiliser des noms d'attributs en dur dans le code, ou bien, utiliser la fonction ldap_get_attributes() pour y accéder dynamiquement.

LDAP autorise plus d'une entrée par attribut, ce qui permet , par exemple, d'étiqueter tous les adresses email d'un utilisateur avec l'attribut "mail"

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

Exemple 1. Liste toutes les valeurs avec l'attribut "mail"

// $ds est l'identifiant de lien pour ce dossier

// $sr est un résultat de recherche valide, obtenu lors d'une recherche
// précédente

// $entry est un identifiant valide d'entrée

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

echo $values["count"]." Adresse email dans ce résultat.<p>";

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

Précédent

Sommaire

Suivant

ldap_get_entries

Chapitre

ldap_list