(PHP 4, PHP 5)
ldap_list — Einstufige Suche
$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().