ldap_parse_result
(PHP 4 >= 4.0.5, PHP 5, PHP 7, PHP 8)
ldap_parse_result — Extrai informação de resultado
Descrição
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.
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
}
?>