ldap_get_attributes

(PHP 3, PHP 4 , PHP 5)

ldap_get_attributes -- Lit les attributs d'une entrée

Description

array ldap_get_attributes ( resource link_identifier, resource result_entry_identifier )

ldap_get_attributes() retourne le détail des informations d'une entrée sous la forme d'un tableau multidimensionnel ou FALSE en cas d'erreur.

ldap_get_attributes() sert à simplifier la lecture des attributs et de leur valeur pour une entrée dans un résultat de recherche. La valeur retournée est un tableau multidimensionnel, avec les noms des attributs et leurs valeurs.

Une fois que vous avez repéré une entrée dans un dossier, vous pouvez obtenir plus d'informations sur elle avec cette fonction. Elle pourrait être utilisée dans le cadre d'une application qui cartographie les dossiers et les entrées. Dans de nombreuses applications, vous recherchez des entrées ayant un attribut précis, sans vous soucier des autres attributs.

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

return_value["count"] = nombre d'attributs dans l'entrée
return_value[0] = premier attribut
return_value[n] = n-ième attribut

return_value["attribute"]["count"] = nombre de valeurs de l'attribut
return_value["attribute"][0] = première valeur de l'attribut
return_value["attribute"][i] = (i+1)-ème valeur de l'attribut

Exemple 2. Affiche la liste des attributs d'une entrée

<?php
// $ds est une ressource de connexion valide

// $sr est une recherche valide, issue d'une opération
// précédente

$entry = ldap_first_entry($ds, $sr);

$attrs = ldap_get_attributes($ds, $entry);

echo
$attrs["count"] . " attributs dans cette entrée :<p>";

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

Voir aussi ldap_first_attribute() et ldap_next_attribute().