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.

    Changelog

    VersionBeschreibung
    8.1.0 Der Parameter ldap erwartet nun eine LDAP\Connection-Instanz; vorher wurde eine gültige ldap link-Ressource erwartet.
    8.1.0 Der Parameter entry erwartet nun eine LDAP\ResultEntry-Instanz; vorher wurde eine gültige ldap result entry-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 />";
    }
    ?>

    Siehe auch

    To Top