JavaScript Editor Javascript debugger     Website design 

ldap_compare

Compare value of attribute found in entry specified with DN (PHP 4 >= 4.0.2, PHP 5)
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().

dn

The distinguished name of an LDAP entity.

attribute

The attribute name.

value

The compared value.

Return Values

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

Examples

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

Example 1113. Complete example of password check

<?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.";
}
?>


Notes

Warning:

ldap_compare() can NOT be used to compare BINARY values!