ldap_list

(PHP 3, PHP 4 )

ldap_list -- Einstufige Suche

Beschreibung

resource ldap_list ( resource Verbindungs-Kennung, string basis_dn, string filter [, array merkmale [, int nur_merkmmale [, int größenbegrenzung [, int zeitbegrenzung [, int deref]]]]])

Rückgabewert: im Erfolgsfall eine Such-Ergebnis-Kennung,im Fehlerfall FALSE.

Die ldap_list() Funktion führt die Suche für einen gegebenen filter im Verzeichnis mit der Reichweite von LDAP_SCOPE_ONELEVEL durch.

LDAP_SCOPE_ONELEVEL bedeutet, dass die Suche nur Informationen liefert, die direkt unterhalb der Stufe liegen, die durch die Angabe des basis_dn im Auruf bestimmt wird. (Das entspricht der Eingabe von "ls", die eine Liste von Dateien und Verzeichnissen des aktuellen Arbeitsverzeichnisses anzeigt.)

Der Aufruf dieser Funktion nimmt 5 optionale Parameter entgegen. Siehe die Anmerkungen zu ldap_search().

Anmerkung: Diese wahlfreien Parameter wurden in 4.0.2 hinzugefügt: attrsonly, größenbegrenzung, zeitbegrenzung, deref.

Beispiel 1. Erzeugung einer Liste aller Organisationseinheiten einer Organisation

// $ds gültige Verbindungs-Kennung für einen Verzeichnis-Server

$basis_dn = "o=Meine Firma, c=DE";
$nur_dieses = array("ou");

$sr=ldap_list($ds, $basis_dn, "ou=*", $nur_dieses);

$info = ldap_get_entries($ds, $sr);

for ($i=0; $i<$info["count"]; $i++)
    echo $info[$i]["ou"][0] ;

Anmerkung: Seit der Version 4.0.5 ist es außerdem möglich parallele Suchen durchzuführen. Für Details siehe ldap_search().