ldap_error

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

ldap_error — Retorna 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

Melhore Esta Página

Aprenda Como Melhorar Esta Página • Envie uma Solicitação de Modificação • Reporte um Problema

＋adicione uma nota

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

down

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

down

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() );
?>

＋adicione uma nota