ldap_get_values

(PHP 4, PHP 5)

ldap_get_values — Получает все значения из записи результата

Описание

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

Читает все значения атрибута в записи результата.

Эта функция требует result_entry_identifier, а следовательно, перед ней должны быть запущена одна из функций ldap поиска и один из результатов их вызова для получения отдельной записи.

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

Список параметров

link_identifier: Идентификатор ссылки LDAP, возвращенный ldap_connect().
result_entry_identifier
attribute

Возвращаемые значения

Возвращает массив значений для атрибута в случае успеха, и FALSE в случае ошибки. Число значений может быть найдено по индексу "count" в результирующем массиве. Отдельные значения могут быть доступны по целочисленным индексам в массиве. Первый индекс 0.

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

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

Примеры

Пример #1 Список всех значений атрибута "mail" для записи каталога


<?php
// $ds верный идентификатор ссылки на сервер директории

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

// $entry верный идентификатор записи из вызова функции
//        вернувшей запись директории

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

echo $values["count"] . " адреса email для этой записи.<br />";

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

Смотрите также

ldap_get_values_len() - Получить все бинарные значения из записи результата