ldap_error

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

ldap_errorRetorna a mensagem de erro do último comando LDAP

Descrição

ldap_error(LDAP\Connection $ldap): string

Retorna a mensagem de erro em uma string explicando o erro gerado pelo último comando LDAP para o ldap informado. Enquanto que os números de erro do LDAP são padronizados, bibliotecas diferentes retornam mensagens de texto diferentes. Nunca verifique por uma mensagem de texto específica, use sempre verificação do número do erro.

A menos que o nível de alertas seja reduzido suficientemente no php.ini ou que os comandos LDAP sejam prefixados com caracteres @ para suprimir alertas na saída, os erros gerados sempre irão aparecer na saída HTML.

Parâmetros

ldap

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

Valor Retornado

Retorna a mensagem de erro como uma string.

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.

Veja Também

  • ldap_err2str() - Converte um número de erro LDAP em uma mensagem de erro string
  • ldap_errno() - Retorna o número de erro LDAP do último comando

adicione uma nota

Notas Enviadas por Usuários (em inglês) 2 notes

up
15
Michael Newton
6 years ago
Note that you can sometimes get more detailed error messages by getting the value of the LDAP_OPT_DIAGNOSTIC_MESSAGE option.

For example, after a recent connection error the two gave very different info:

<?php
$conn
= ldap_connect($server);
ldap_search($conn, $dn, $query);

echo
"ldap_error: " . ldap_error($conn);
ldap_get_option($conn, LDAP_OPT_DIAGNOSTIC_MESSAGE, $err);
echo
"ldap_get_option: $err";
?>

This resulted in:

ldap_error: Can't contact LDAP server
ldap_get_option: TLS: hostname does not match CN in peer certificate
up
5
edA-qa at disemia dot com
16 years ago
For those wondering, this function appears to do the same thing as:
<?php
ldap_err2str
( ldap_errno() );
?>
To Top