PHP Manual
LDAP Funktionen
Liefert die Merkmale eines Eintrags aus einem Suchergebnis

ldap_get_attributes

(PHP 4, PHP 5, PHP 7, PHP 8)

ldap_get_attributes — Liefert die Merkmale eines Eintrags aus einem Suchergebnis

Beschreibung

ldap_get_attributes(LDAP\Connection $ldap, LDAP\ResultEntry $entry): array

Liest Merkmale und Werte eines Eintrags im Suchergebnis.

Nachdem ein bestimmter Eintrag in dem Verzeichnis lokalisiert wurde, kann mit dieser Funktion herausgefunden werden, welche Informationen für diesen Eintrag verfügbar sind. Diese Funktion würde in einer Anwendung verwendet werden, die Verzeichniseinträge "durchstöbert" und/oder wo die Struktur der Verzeichniseinträge nicht bekannt ist. In vielen Anwendungen wird nach einem bestimmten Merkmal gesucht, z. B. einer E-Mail-Adresse oder einem Nachnamen, und welche anderen Daten verfügbar sind, interessiert nicht.

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

Parameter-Liste

ldap: Eine LDAP\ConnectionInstanz, die von ldap_connect() zurückgegeben wurde.
entry: Eine LDAP\ResultEntry-Instanz

Rückgabewerte

Gibt im Erfolgfall die vollständige Eintragsinformation in einem mehrdimensionalen Array zurück und false im Fehlerfall.

Changelog

Version	Beschreibung
8.1.0	Der Parameter `ldap` erwartet nun eine LDAP\Connection-Instanz; vorher wurde eine Ressource erwartet.
8.1.0	Der Parameter `entry` erwartet nun eine LDAP\ResultEntry-Instanz; vorher wurde eine Ressource erwartet.

Beispiele

Beispiel #1 Anzeigen der Liste der Merkmale für einen ausgewählten Verzeichnis-Eintrag


<?php
// $ds ist eine gültige LDAP\Connection-Instanz für einen Verzeichnis-Server

// $sr ist 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 />";
}
?>