PHP Conference Japan 2024

ldap_errno

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

ldap_errno返回上一个 LDAP 命令的 LDAP 错误号

描述

ldap_errno(LDAP\Connection $ldap): int

返回上一个 LDAP 命令返回的标准化错误号。可以使用 ldap_err2str() 将此数字转换为文本错误消息。

参数

ldap

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

返回值

返回此链接上一个 LDAP 命令的 LDAP 错误号。

变更日志

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

示例

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

示例 #1 生成和捕获错误

<?php
// 此示例包含一个错误,我们将捕获它。
$ld = ldap_connect("localhost");
$bind = ldap_bind($ld);
// 过滤器表达式中的语法错误 (errno 87),
// 必须是 "objectclass=*" 才能工作。
$res = @ldap_search($ld, "o=Myorg, c=DE", "objectclass");
if (!
$res) {
echo
"LDAP-Errno: " . ldap_errno($ld) . "<br />\n";
echo
"LDAP-Error: " . ldap_error($ld) . "<br />\n";
die(
"Argh!<br />\n");
}
$info = ldap_get_entries($ld, $res);
echo
$info["count"] . " matching entries.<br />\n";
?>

参见

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

添加注释

用户贡献的注释 2 条注释

1
ahall at mirapoint dot com
23 年前
一些不错的入门错误代码。如果您想检测由于记录已存在而导致 ldap_add 失败,ldap_error == 0x44。这意味着,您可以执行以下操作

$r = ldap_add($ds, $dn, $info);
if (!$r) {
if (ldap_errno($ds) == 0x44) {
// 对其进行处理
} else {
// 真正的错误
}
}

同样,在 ldap_delete 上,如果您尝试删除不存在的内容,则会得到 0x20 值 (不存在的对象)。
0
匿名
22 年前
常见的 LDAP 错误代码

LDAP_SUCCESS 0x00
LDAP_OPERATIONS_ERROR 0x01
LDAP_PROTOCOL_ERROR 0x02
LDAP_TIMELIMIT_EXCEEDED 0x03
LDAP_SIZELIMIT_EXCEEDED 0x04
LDAP_COMPARE_FALSE 0x05
LDAP_COMPARE_TRUE 0x06
LDAP_AUTH_METHOD_NOT_SUPPORTED 0x07
LDAP_STRONG_AUTH_REQUIRED 0x08
// 在 LDAPv3 中未使用
LDAP_PARTIAL_RESULTS 0x09

// 接下来 5 个在 LDAPv3 中新增
LDAP_REFERRAL 0x0a
LDAP_ADMINLIMIT_EXCEEDED 0x0b
LDAP_UNAVAILABLE_CRITICAL_EXTENSION 0x0c
LDAP_CONFIDENTIALITY_REQUIRED 0x0d
LDAP_SASL_BIND_INPROGRESS 0x0e

LDAP_NO_SUCH_ATTRIBUTE 0x10
LDAP_UNDEFINED_TYPE 0x11
LDAP_INAPPROPRIATE_MATCHING 0x12
LDAP_CONSTRAINT_VIOLATION 0x13
LDAP_TYPE_OR_VALUE_EXISTS 0x14
LDAP_INVALID_SYNTAX 0x15

LDAP_NO_SUCH_OBJECT 0x20 /* 32 */
LDAP_ALIAS_PROBLEM 0x21
LDAP_INVALID_DN_SYNTAX 0x22
// 接下来两个在 LDAPv3 中未使用
LDAP_IS_LEAF 0x23
LDAP_ALIAS_DEREF_PROBLEM 0x24

LDAP_INAPPROPRIATE_AUTH 0x30 /* 48 */
LDAP_INVALID_CREDENTIALS 0x31 /* 49 */
LDAP_INSUFFICIENT_ACCESS 0x32
LDAP_BUSY 0x33
LDAP_UNAVAILABLE 0x34
LDAP_UNWILLING_TO_PERFORM 0x35
LDAP_LOOP_DETECT 0x36

LDAP_SORT_CONTROL_MISSING 0x3C /* 60 */
LDAP_INDEX_RANGE_ERROR 0x3D /* 61 */

LDAP_NAMING_VIOLATION 0x40
LDAP_OBJECT_CLASS_VIOLATION 0x41
LDAP_NOT_ALLOWED_ON_NONLEAF 0x42
LDAP_NOT_ALLOWED_ON_RDN 0x43
LDAP_ALREADY_EXISTS 0x44 /* 68 */
LDAP_NO_OBJECT_CLASS_MODS 0x45
LDAP_RESULTS_TOO_LARGE 0x46
// 接下来两个用于 LDAPv3
LDAP_AFFECTS_MULTIPLE_DSAS 0x47
LDAP_OTHER 0x50

// 由某些 API 使用
LDAP_SERVER_DOWN 0x51
LDAP_LOCAL_ERROR 0x52
LDAP_ENCODING_ERROR 0x53
LDAP_DECODING_ERROR 0x54
LDAP_TIMEOUT 0x55
LDAP_AUTH_UNKNOWN 0x56
LDAP_FILTER_ERROR 0x57 /* 87 */
LDAP_USER_CANCELLED 0x58
LDAP_PARAM_ERROR 0x59
LDAP_NO_MEMORY 0x5a

// 预备 LDAPv3 代码
LDAP_CONNECT_ERROR 0x5b
LDAP_NOT_SUPPORTED 0x5c
LDAP_CONTROL_NOT_FOUND 0x5d
LDAP_NO_RESULTS_RETURNED 0x5e
LDAP_MORE_RESULTS_TO_RETURN 0x5f
LDAP_CLIENT_LOOP 0x60
LDAP_REFERRAL_LIMIT_EXCEEDED 0x61
To Top