Извлечь информацию из результата

# ldap_parse_result

(PHP 4 >= 4.0.5, PHP 5, PHP 7, PHP 8)

ldap_parse_result — Извлечь информацию из результата

### Описание

function ldap_parse_result(
LDAP\Connection `$ldap`,
LDAP\Result `$result`,
int `&$error_code`,
string `&$matched_dn` = `null`,
string `&$error_message` = `null`,
array `&$referrals` = `null`,
array `&$controls` = `null`
): bool

Обрабатывает результат поиска LDAP.

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

`ldap`

  Экземпляр класса LDAP\Connection, который возвращает функция ldap_connect().

`result`

  Экземпляр класса LDAP\Result, который возвращает функция ldap_list() или ldap_search().

`error_code`

  Ссылка на переменную, которой присваивается код ошибки LDAP, или `0`, если нет ошибки.

`matched_dn`

  Ссылка на переменную, которой присваивается найденный DN, если он определяется в запросе, иначе присваивается `null`.

`error_message`

  Ссылка на переменную, которой присваивается сообщение об LDAP-ошибке, или пустая строка, если нет ошибки.

`referrals`

  Ссылка на переменную, которой присваивается массив (array) со всеми отсылками (referral) в виде строк, или пустой массив, если они не были возвращены.

`controls`

  Массив (array) LDAP Controls, которые были отправлены вместо с ответом.

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

Функция возвращает `true`, если выполнилась успешно, или `false`, если возникла ошибка.

### Список изменений

Версия | Описание
--- | ---
8.1.0 | Параметр `ldap` теперь принимает объект LDAP\Connection; раньше параметр ждал ресурс (resource) `ldap link` .
8.1.0 | Параметр `result` теперь принимает объект LDAP\Result; раньше параметр ждал ресурс (resource) `ldap result`.
7.3.0 | Добавлена поддержка параметра `controls`

### Примеры

Пример #1 Пример использования ldap_parse_result()

    <?php
    $result = ldap_search($ldap, "cn=userref,dc=my-domain,dc=com", "(cn=user*)");
    $errcode = $dn = $errmsg = $refs =  null;
    if (ldap_parse_result($ldap, $result, $errcode, $dn, $errmsg, $refs)) {
        // различные операции с $errcode, $dn, $errmsg и $refs
    }
    ?>

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