PHP Handbuch
ZurückVor

ldap_list

(PHP 3, PHP 4 >= 4.0.0)

ldap_list -- Einstufige Suche

Beschreibung

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

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

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

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

ZurückAnfangVor
ldap_get_values_lenHochldap_modify