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.

Hinweis:
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] ;

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