PHP Conference Japan 2024

ldap_error

(PHP 4、PHP 5、PHP 7、PHP 8)

ldap_error返回上一个 LDAP 命令的 LDAP 错误消息

描述

ldap_error(LDAP\Connection $ldap): string

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

除非您在 php.ini 中充分降低警告级别,或者在 LDAP 命令前加上 @(at)字符以抑制警告输出,否则生成的错误也会显示在您的 HTML 输出中。

参数

ldap

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

返回值

返回字符串错误消息。

变更日志

版本 描述
8.1.0 ldap 参数现在期望一个 LDAP\Connection 实例;以前,期望一个有效的 ldap link 资源

参见

添加注释

用户贡献的注释 2 条注释

15
Michael Newton
7 年前
请注意,有时可以通过获取 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