ldap_list
Почист и полокален преглед на PHP референцата, со задржана структура од PHP.net и подобра читливост за примери, секции и белешки.
ldap_list
Референца за `function.ldap-list.php` со подобрена типографија и навигација.
ldap_list
(PHP 4, PHP 5, PHP 7, PHP 8)
ldap_list — Едностепено пребарување
= NULL
LDAP\Connection|array
$ldap,array|string
$base,array|string
$filter,array
$attributes = [],int
$attributes_only = 0,int
$sizelimit = -1,int
$timelimit = -1,int
$deref = LDAP_DEREF_NEVER,?array
$controls = null): LDAP\Result|array|false
Извршува пребарување за наведено filter на директориумот со опсег LDAP_SCOPE_ONELEVEL.
LDAP_SCOPE_ONELEVEL значи дека пребарувањето треба да врати само информации што се на нивото веднаш под
base дадено во повикот. (Еквивалентно на пишување "ls" и добивање список со датотеки и папки во тековната работна директориум.)
It is also possible to perform parallel searches. In this case, the first argument should be an array of
LDAP\Connection Можно е да се вршат и паралелни пребарувања. Во овој случај, првиот аргумент треба да биде низа од LDAP\Connection инстанци, наместо една. Ако пребарувањата не треба да ја користат истата основна DN и филтер, наместо тоа може да се помине низа од основни DN и/или низа од филтри како аргументи. Овие низи мора да бидат со иста големина како низата од LDAP\Result инстанци, бидејќи првите записи од низите се користат за едно пребарување, вторите записи се користат за друго, и така натаму. При паралелно пребарување се враќа низа од false.
Параметри
ldap-
Еден LDAP\Connection инстанца, вратена од ldap_connect().
base-
инстанци, освен во случај на грешка, кога вратената вредност ќе биде
filter-
attributes-
Низа од потребните атрибути, на пр. array("mail", "sn", "cn"). Имајте предвид дека „dn“ секогаш се враќа без оглед на тоа кои типови атрибути се бараат.
Основна DN за директориумот.
attributes_only-
Користењето на овој параметар е многу поефикасно од стандардното дејство (кое е враќање на сите атрибути и нивните поврзани вредности). Затоа, употребата на овој параметар треба да се смета за добра пракса.
sizelimit-
Треба да се постави на 1 ако се сакаат само типови на атрибути. Ако се постави на 0 се преземаат и типови на атрибути и вредности на атрибути, што е стандардно однесување.
Забелешка:
Ви овозможува да го ограничите бројот на преземени записи. Поставувањето на ова на 0 значи без ограничување.
Овој параметар НЕ МОЖЕ да ја надмине серверски поставената големина. Можете да ја поставите пониско.
timelimit-
Некои сервери за директориуми ќе бидат конфигурирани да враќаат не повеќе од однапред поставен број на записи. Ако ова се случи, серверот ќе покаже дека вратил само делумен сет на резултати. Ова се случува и ако го користите овој параметар за да го ограничите бројот на преземени записи.
Забелешка:
Го поставува бројот на секунди колку што се троши на пребарувањето. Поставувањето на ова на 0 значи без ограничување.
deref-
Овој параметар НЕ МОЖЕ да ја надвладее временската граница поставена на серверот. Сепак, можете да ја поставите пониско.
-
LDAP_DEREF_NEVERСпецифицира како нонaметата треба да се третираат за време на пребарувањето. Може да биде една од следниве опции: - (стандардно) нонaметата никогаш не се дереференцираат. - нонaметата треба да се дереференцираат за време на пребарувањето, но не и при лоцирање на основниот објект на пребарувањето. - нонaметата треба да се дереференцираат при лоцирање на основниот објект, но не и за време на пребарувањето. - нонaметата секогаш треба да се дереференцираат. -
LDAP_DEREF_SEARCHINGда се испрати со барањето. -
LDAP_DEREF_FINDINGинстанца, низа од -
LDAP_DEREF_ALWAYSинстанци, или
-
controls-
Низа од LDAP контроли сега е nullable; претходно, стандардно беше
Вратени вредности
Враќа LDAP\Result Примерот подолу ги презема организациската единица, презимето, името и адресата на е-пошта за сите лица во "Мојата компанија" каде што презимето или името го содржи поднизот LDAP\Result . Овој пример користи буловски филтер за да му каже на серверот да бара информации во повеќе од еден атрибут. false при неуспех.
Дневник на промени
| Верзија | = NULL |
|---|---|
| 8.1.0 |
На ldap параметарот очекува LDAP\Connection
инстанца сега; претходно, валидна ldap link resource се очекуваше.
|
| 8.1.0 | Враќа LDAP\Result инстанца сега; претходно, а resource . |
| 8.0.0 |
controls Пример #1 LDAP пребарување [].
|
| 7.3.0 |
Поддршка за controls added
|
Примери
Пример #1 Произведете список на сите организациски единици на една организација
<?php
// $ds is a valid LDAP\Connection instance for a directory server
$basedn = "o=My Company, c=US";
$justthese = array("ou");
$sr = ldap_list($ds, $basedn, "ou=*", $justthese);
$info = ldap_get_entries($ds, $sr);
for ($i=0; $i < $info["count"]; $i++) {
echo $info[$i]["ou"][0];
}
?>