ldap_errno

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

    ldap_errno — Return the LDAP error number of the last LDAP command

    说明

    ldap_errno(LDAP\Connection $ldap): int

    Returns the standardized error number returned by the last LDAP command. This number can be converted into a textual error message using ldap_err2str().

    参数

    ldap

    通过 ldap_connect() 返回的 LDAP\Connection 实例。

    返回值

    Return the LDAP error number of the last LDAP command for this link.

    更新日志

    版本 说明
    8.1.0 现在 ldap 参数接受 LDAP\Connection 实例，之前接受有效的 ldap link resource。

    示例

    Unless you lower your warning level in your php.ini sufficiently or prefix your LDAP commands with @ (at) characters to suppress warning output, the errors generated will also show up in your HTML output.

    示例 #1 Generating and catching an error

    <?php
    // This example contains an error, which we will catch.
    $ld = ldap_connect("localhost");
    $bind = ldap_bind($ld);
    // syntax error in filter expression (errno 87),
    // must be "objectclass=*" to work.
    $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() - Convert LDAP error number into string error message
    • ldap_error() - Return the LDAP error message of the last LDAP command

    改进此页面

    了解如何改进此页面 • 提交拉取请求 • 报告一个错误
    ＋添加备注

    用户贡献的备注 2 notes

    up
    0
    Anonymous
    22 years ago
    Common LDAP error codes

    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
    // Not used in LDAPv3
    LDAP_PARTIAL_RESULTS 0x09

    // Next 5 new in 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
    // Next two not used in 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
    // Next two for LDAPv3
    LDAP_AFFECTS_MULTIPLE_DSAS 0x47
    LDAP_OTHER 0x50

    // Used by some APIs
    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

    // Preliminary LDAPv3 codes
    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
    up
    0
    ahall at mirapoint dot com
    23 years ago
    Couple of good error codes to get started. If you want to detect failure of ldap_add due to the record already existing, ldap_error == 0x44. This means, you can do something like:

    $r = ldap_add($ds, $dn, $info);
    if (!$r) {
    if (ldap_errno($ds) == 0x44) {
    // Do something about it
    } else {
    // A real failure
    }
    }

    Similarly, on ldap_delete, you will get a 0x20 value (No Such Object) if you try to delete something that isn't there.
    ＋添加备注
    To Top