Учебник РНР
НазадВперёд

ldap_get_values

(PHP 3, PHP 4)

ldap_get_values - получает все значения из результирующего вхождения.

Описание

array ldap_get_values (resource link_identifier, resource result_entry_identifier, string attribute)

Возвращает массив значений атрибута при успехе, FALSE при ошибке.

ldap_get_values() используется для чтения всех значений атрибута вхождения в результате. Вхождение специфицируется параметром result_entry_identifier. Количество значений можно определить через индексирование результирующего массива. Доступ к отдельным значениям можно получить по целочисленному индексу массива. Первый индекс 0.

Для этого вызова требуется result_entry_identifier, поэтому ему должен предшествовать один из вызовов ldap-поиска и один из вызовов получения конкретного вхождения.

Ваше приложение должно быть жёстко кодировано для поиска определённых атрибутов (таких как "surname" или "mail"), либо вы должны использовать вызов ldap_get_attributes() для работы с существующими атрибутами данного вхождения.

LDAP разрешает более одного вхождения на атрибут, поэтому можно, например, хранить количество email-адресов одной директории маркированными атрибутом "mail".


return_value["count"] = количество значений атрибута
return_value[0] = первое значение атрибута
return_value[i] = i'ное значение атрибута

Пример 1. Список всех значений атрибута "mail" для вхождения директории
// $ds это правильный идентификатор ссылки для сервера директорий

// $sr это правильный результат поиска от предыдущего вызова
//     поиска ldap directory

// $entry это правильный идентификатор вхождения от одного из предыдущих вызовов,
//        возвратившего вхождение директории

$values = ldap_get_values($ds, $entry,"mail");

echo $values["count"]." email addresses for this entry.<p>";

for ($i=0; $i < $values["count"]; $i++)
    echo $values[$i]."<br>";

Назад Оглавление Вперёд
ldap_get_values_len Вверхldap_list