ldap_error

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

    ldap_error — 返回最后一个 LDAP 命令的 LDAP 错误消息

    描述

    ldap_error(LDAP\Connection $ldap): string

    返回一个字符串错误消息，解释给定 ldap 的最后一个 LDAP 命令生成的错误。虽然 LDAP errno 号码是标准化的，但不同的库返回不同的甚至本地化的文本错误消息。不要检查特定的错误消息文本，而应始终使用错误号进行检查。

    除非您在 php.ini 中将警告级别降低到足够低，或者在您的 LDAP 命令前加上 @（at）字符以抑制警告输出，否则生成的错误也会显示在您的 HTML 输出中。

    参数

    ldap

    一个 LDAP\Connection 实例，由 ldap_connect() 返回。

    返回值

    返回字符串错误消息。

    变更日志

    版本 描述
    8.1.0 ldap 参数现在需要一个 LDAP\Connection 实例；以前，需要一个有效的 ldap link 资源。

    参见

    • ldap_err2str() - 将 LDAP 错误号转换为字符串错误消息
    • ldap_errno() - 返回最后一个 LDAP 命令的 LDAP 错误号

    改进此页面

    了解如何改进此页面 • 提交拉取请求 • 报告错误
    ＋添加笔记

    用户贡献笔记 2 笔记

    15
    Michael Newton
    6 年前
    请注意，您有时可以通过获取 LDAP_OPT_DIAGNOSTIC_MESSAGE 选项的值来获得更详细的错误消息。

    例如，在最近的连接错误后，这两个提供了非常不同的信息

    <?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";
    ?>

    这导致了

    ldap_error: 无法联系 LDAP 服务器
    ldap_get_option: TLS: 主机名与对等证书中的 CN 不匹配
    5
    edA-qa at disemia dot com
    16 年前
    对于那些想知道的人来说，这个函数似乎与以下函数相同
    <?php
    ldap_err2str    ( ldap_errno() );
    ?>
    ＋添加笔记
    To Top