Manuel PHP
Précédent |  | Suivant

# ldap_get_values

(PHP 3 <= 3.0.18, PHP 4 >= 4.0.0)

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

## Description

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

ldap_get_option() retourne un tableau de valeurs en cas de succès, et `TRUE` 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.

ldap_get_values() nécessite un pointeur de résultat `result_entry_identifier`, ce qui implique qu'il ait é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 valeurs de l'attribut
return_value[0] = première valeur de l'attribut
return_value[i] = n-ième valeur de attribut

Exemple 1. Liste toutes les valeurs avec l'attribut "mail"
    <?php
    // $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_option | Niveau supérieur | ldap_get_values_len