array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.ldap-control-paged-result.php', 1 => 'ldap_control_paged_result', ), 'up' => array ( 0 => 'ref.ldap.php', 1 => 'Функции LDAP', ), 'prev' => array ( 0 => 'function.ldap-control-paged-result-response.php', 1 => 'ldap_control_paged_result_response', ), 'next' => array ( 0 => 'function.ldap-count-entries.php', 1 => 'ldap_count_entries', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/ldap/functions/ldap-control-paged-result.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 5 >= 5.4.0, PHP 7)
ldap_control_paged_result — Послать серверу LDAP данные для использования постраничного извлечения результата
Функцию объявили УСТАРЕВШЕЙ в PHP 7.4.0
и УДАЛИЛИ в PHP 8.0.0.
Вместо этой функции вызывают функцию ldap_search()
с передачей в параметр controls
управляющих объектов протокола LDAP.
Раздел «Управляющие объекты LDAP»
даёт дополнительную информацию.
$link
,$pagesize
,$iscritical
= false
,$cookie
= ""Разрешает работу с LDAP в постраничном режиме, путём отправки желаемых настроек (размер страницы, куки и т.д.)
link
Ресурс LDAP, возвращаемый функцией ldap_connect().
pagesize
Количество записей на страницу.
iscritical
Определяет, является ли постраничный режим критичным или нет.
Если true
и если сервер не поддерживает постраничную работу,
поиск вернёт пустой результат.
cookie
Непрозрачная структура, посылаемая сервером (ldap_control_paged_result_response()).
Возвращает true
в случае успешного выполнения или false
, если возникла ошибка.
Версия | Описание |
---|---|
8.0.0 | Функция была удалена. |
7.4.0 | Функция объявлена устаревшей. |
Пример ниже демонстрирует извлечение первой страницы результата поиска с использованием размера страницы равного одной записи.
Пример #1 Постраничная работа с LDAP
<?php
// $ds - идентификатор соединения (смотрите ldap_connect)
ldap_set_option($ds, LDAP_OPT_PROTOCOL_VERSION, 3);
$dn = 'ou=example,dc=org';
$filter = '(|(sn=Doe*)(givenname=John*))';
$justthese = array('ou', 'sn', 'givenname', 'mail');
// разрешаем постраничную работу с размером страницы равному одной записи.
ldap_control_paged_result($ds, 1);
$sr = ldap_search($ds, $dn, $filter, $justthese);
$info = ldap_get_entries($ds, $sr);
echo $info['count'] . ' записей возвращено' . PHP_EOL;
Пример ниже демонстрирует извлечение первой страницы результата поиска с использованием размера страницы равного ста записям.
Пример #2 Постраничная работа с LDAP
<?php
// $ds - идентификатор соединения (смотрите ldap_connect)
ldap_set_option($ds, LDAP_OPT_PROTOCOL_VERSION, 3);
$dn = 'ou=example,dc=org';
$filter = '(|(sn=Doe*)(givenname=John*))';
$justthese = array('ou', 'sn', 'givenname', 'mail');
// разрешаем постраничную работу с размером страницы равному ста записям.
$pageSize = 100;
$cookie = '';
do {
ldap_control_paged_result($ds, $pageSize, true, $cookie);
$result = ldap_search($ds, $dn, $filter, $justthese);
$entries = ldap_get_entries($ds, $result);
foreach ($entries as $e) {
echo $e['dn'] . PHP_EOL;
}
ldap_control_paged_result_response($ds, $result, $cookie);
} while($cookie !== null && $cookie != '');
Замечание:
Постраничный режим появился в версии протокола LDAPv3.