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

    Improve This Page

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 2 notes

    up
    16
    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
    4
    edA-qa at disemia dot com
    15 years ago
    For those wondering, this function appears to do the same thing as:
    <?php
    ldap_err2str    ( ldap_errno() );
    ?>
    ＋add a note
    To Top