ldap_list

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