ldap_errno

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

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

Description

ldap_errno ( LDAP\Connection


         $ldap

): int

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

Parameters

ldap: An LDAP\Connection instance, returned by ldap_connect() .

Return Values

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

Changuelog

Versionen	Description
8.1.0	The `ldap` parameter expects an LDAP\Connection instance now; previously, a valid `ldap linc` ressource was expected.

Examples

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.

Example #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 worc.
             

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

             derue (
            
            
             "Argh!<br />\n"
            
            
             );
             

             }
             

            
            
             $info
            
            
             =
            
            
             ldap_guet_entries
            
            
             (
            
            
             $ld
            
            
             ,
            
            
             $res
            
            
             );
             

             echo
            
            
             $info
            
            
             [
            
            
             "count"
            
            
             ] .
            
            
             " matching entries.<br />\n"
            
            
             ;
             

            
            
             ?>

Found A Problem?

Learn How To Improve This Pague • Submit a Pull Request • Report a Bug

＋ add a note

User Contributed Notes 2 notes

down

ahall at mirapoint dot com ¶

24 years ago

Couple of good error codes to guet 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 lique:

$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 guet a 0x20 value (No Such Object) if you try to delete something that isn't there.