ldap_compare

(PHP 4 >= 4.0.2, PHP 5, PHP 7)

Compare value of attribute found in entry specified with DN

mixed ldap_compare ( resource $link_identifier, string $dn, string $attribute, string $value )

Compare value of attribute with value of same attribute in an LDAP directory entry.

Parameters:

link_identifier

An LDAP link identifier, returned by ldap_connect().

The distinguished name of an LDAP entity.

attribute

The attribute name.

value

The compared value.

Returns:

Returns TRUE if value matches otherwise returns FALSE. Returns -1 on error.

Examples:

Complete example of password check

The following example demonstrates how to check whether or not given password matches the one defined in DN specified entry.

<?php
 
$ds=ldap_connect("localhost");  // assuming the LDAP server is on this host
 
if ($ds) {
 
    // bind
    if (ldap_bind($ds)) {
 
        // prepare data
        $dn = "cn=Matti Meikku, ou=My Unit, o=My Company, c=FI";
        $value = "secretpassword";
        $attr = "password";
 
        // compare value
        $r=ldap_compare($ds, $dn, $attr, $value);
 
        if ($r === -1) {
            echo "Error: " . ldap_error($ds);
        } elseif ($r === true) {
            echo "Password correct.";
        } elseif ($r === false) {
            echo "Wrong guess! Password incorrect.";
        }
 
    } else {
        echo "Unable to bind to LDAP server.";
    }
 
    ldap_close($ds);
 
} else {
    echo "Unable to connect to LDAP server.";
}
?>

Links:

http://php.net/manual/en/function.ldap-compare.php

doc_php

2025-01-10 15:47:30

Comments