ldap_get_attributes
(PHP 4, PHP 5)
ldap_get_attributes — Liefert Merkmale eines Suchergebnis-Eintrags
Beschreibung
Rückgabewert: im Erfolgsfall wird die gesamte Information eines Eintrags in einem multidimensionalen Array zurückgegeben; im Fehlerfall FALSE.
Die ldap_get_attributes() Funktion wird verwendet um das Lesen der Merkmale und Werte eines Eintrags im Suchergebnis zu vereinfachen. Der Rückgabewert ist ein multidimensionales Array aus Merkmalen und Werten.
Nachdem Sie einen bestimmten Eintrag in dem Verzeichnis lokalisiert haben, können Sie mit dieser Funktion herausfinden, welche Informationen für diesen Eintrag verfügbar sind. Diese Funktion würden Sie in einer Anwendung verwenden, die Verzeichniseinträge "durchstöbert" und/oder wo Sie die Struktur der Verzeichniseinträge nicht kennen. In vielen Anwendungen suchen Sie nach einem bestimmten Merkmal wie einer email-Adresse oder einem Nachnamen und interessieren sich nicht dafür, welche anderen Daten verfügbar sind.
return_value["count"] = Anzahl der Merkmale des Eintrags return_value[0] = das erste Merkmal return_value[n] = das n-te Merkmal return_value["merkmal"]["count"] = Anzahl der Werte des Merkmals return_value["merkmal"][0] = der erste Wert des Merkmals return_value["merkmal"][i] = der i+1-te Wert des Merkmals
Example#1 Anzeigen der Liste der Merkmale für einen ausgewählten Verzeichnis-Eintrag
// $ds die Verbindungs-Kennung für das Verzeichnis
/* $sr ein gültiges Suchergebnis eines früheren Aufrufs einer der ldap
Verzeichnis Suchfunktionen */
$entry = ldap_first_entry($ds, $sr);
$attrs = ldap_get_attributes($ds, $entry);
echo $attrs["count"]." Merkmale für diesen Eintrag:<p>";
for ($i=0; $i<$attrs["count"]; $i++)
echo $attrs[$i]."<br>";
Siehe auch ldap_first_attribute() und ldap_next_attribute()