PHP Handbuch
Zurück |  | Nach vorne

# 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().

Zurück | Zum Anfang | Nach vorne
ldap_get_values | Nach oben | ldap_mod_add