(PHP 4, PHP 5, PHP 7, PHP 8)
ldap_get_values — Получает все значения из записи результата
Функция Считывает все значения атрибута в записи результата.
Для вызова функции требуется запись entry,
поэтому перед вызовом требуется запустить функцию
LDAP-поиска и вызывать функцию, которая получит отдельную запись.
Приложение либо будет жестко запрограммировано на поиск конкретных атрибутов наподобие "surname" или "mail", либо придётся вызывать функцию ldap_get_attributes(), чтобы разобрать, какие атрибуты существуют для записи.
ldapЭкземпляр класса LDAP\Connection, который возвращает функция ldap_connect().
entryЭкземпляр класса LDAP\ResultEntry.
attribute
Функция возвращает массив значений для атрибута в случае успешного выполнения или false,
если возникла ошибка. Число значений находят по индексу
"count" в результирующем массиве. Отдельные значения
доступны по целочисленным индексам в массиве.
Значение первого индекса равно 0.
LDAP-сервер разрешает хранить больше одной записи для атрибута, поэтому разрешается, например, сохранить много адресов электронной почты для записи каталога одного человека, каждый из которых маркирован атрибутом "mail".
return_value["count"] = число значений атрибута
return_value[0] = первое значение атрибута
return_value[i] = i-ое значение атрибута
| Версия | Описание |
|---|---|
| 8.1.0 |
Параметр ldap теперь ожидает экземпляр класса LDAP\Connection;
раньше параметр ждал ресурс (resource) ldap link .
|
| 8.1.0 |
Параметр entry теперь ожидает экземпляр класса LDAP\ResultEntry;
раньше параметр ждал ресурс (resource) ldap result entry.
|
Пример #1 Список всех значений атрибута "mail" для записи каталога
<?php
// Переменная $ds — допустимый экземпляр класса LDAP\Connection
// Переменная $sr — правильный результат поиска в LDAP-директории
// Переменная $entry — правильный идентификатор записи из вызова функции,
// которая вернула запись директории
$values = ldap_get_values($ds, $entry, "mail");
echo "Количество адресов эл. почты для этой записи: " . $values["count"] . "<br />";
for ($i=0; $i < $values["count"]; $i++) {
echo $values[$i] . "<br />";
}
?>