ldap_get_attributes

(PHP 4, PHP 5, PHP 7)

ldap_get_attributesLiefere Merkmale eines Suchergebnis-Eintrags

Beschreibung

ldap_get_attributes ( resource $link_identifier , resource $result_entry_identifier ) : 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 verwenden 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, wie einer E-Mmail-Adresse oder einem Nachnamen, gesucht, 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

link_identifier

Eine LDAP-Verbindungskennung, geliefert von ldap_connect().

result_entry_identifier

Rückgabewerte

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

Beispiele

Beispiel #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