Google

NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.73 ">

ldap_get_values

(PHP 3, PHP 4 )

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>";
?>