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

# ldap_get_values

(PHP 4, PHP 5, PHP 7, PHP 8)

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

### Описание

function ldap_get_values(LDAP\Connection `$ldap`, LDAP\ResultEntry `$entry`, string `$attribute`): array|false

Функция Считывает все значения атрибута в записи результата.

Для вызова функции требуется запись `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 />";
    }

    ?>

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

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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open