ldap_parse_result

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

ldap_parse_resultExtrai informação de resultado

Descrição

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

Interpreta um resultado de pesquisa LDAP.

Parâmetros

ldap

Uma instância de LDAP\Connection, retornada por ldap_connect().

result

Uma instância de LDAP\Result, retornada por ldap_list() ou ldap_search().

error_code

Uma referência a uma variável que será definida para o código de erro LDAP no resultado, ou 0 se não houve erro.

matched_dn

Uma referência a uma variável que será definida para um DN correspondente se algum foi reconhecido na requisição, caso contrário será definido para null.

error_message

Uma referência a uma variável que será definida para a mensagem de erro LDAP no resultado, ou uma string vazia se não houve erro.

referrals

Uma referência a uma variável que será definida para um array definido para todas as strings referenciadas no resultado, ou um array vazio se nenhuma referência foi retornada.

controls

Um array de Controles LDAP que foram enviados com a resposta.

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha.

Registro de Alterações

Versão Descrição
8.1.0 O parâmetro ldap agora espera uma instância de LDAP\Connection; anteriormente, um resource ldap link válido era esperado.
8.1.0 O parâmetro result agora espera uma instância de LDAP\Result; anteriormente, um resource ldap result válido era esperado.
7.3.0 Adicionado suporte para controls.

Exemplos

Example #1 Exemplo de 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)) {
    // faz alguma coisa com $errcode, $dn, $errmsg e $refs
}
?>