ldap_bind(3) [php man page]

LDAP_BIND(3)								 1							      LDAP_BIND(3)

ldap_bind - Bind to LDAP directory

SYNOPSIS

       bool ldap_bind NULL NULL (resource  $link_identifier, [string  $bind_rdn], [string  $bind_password])

DESCRIPTION

	Binds to the LDAP directory with specified RDN and password.

PARAMETERS

	      o $link_identifier
		- An LDAP link identifier, returned by ldap_connect(3).

	      o $bind_rdn
		-

	      o $bind_password
		-

	If $bind_rdn and $bind_password are not specified, an anonymous bind is attempted.

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

EXAMPLES

       Example #1

	      Using LDAP Bind

	      <?php

	      // using ldap bind
	      $ldaprdn	= 'uname';     // ldap rdn or dn
	      $ldappass = 'password';  // associated password

	      // connect to ldap server
	      $ldapconn = ldap_connect("ldap.example.com")
		  or die("Could not connect to LDAP server.");

	      if ($ldapconn) {

		  // binding to ldap server
		  $ldapbind = ldap_bind($ldapconn, $ldaprdn, $ldappass);

		  // verify binding
		  if ($ldapbind) {
		      echo "LDAP bind successful...";
		  } else {
		      echo "LDAP bind failed...";
		  }

	      }

	      ?>

       Example #2

	      Using LDAP Bind Anonymously

	      <?php

	      //using ldap bind anonymously

	      // connect to ldap server
	      $ldapconn = ldap_connect("ldap.example.com")
		  or die("Could not connect to LDAP server.");

	      if ($ldapconn) {

		  // binding anonymously
		  $ldapbind = ldap_bind($ldapconn);

		  if ($ldapbind) {
		      echo "LDAP bind anonymous successful...";
		  } else {
		      echo "LDAP bind anonymous failed...";
		  }

	      }

	      ?>

SEE ALSO

       ldap_unbind(3).

PHP Documentation Group 													      LDAP_BIND(3)

LDAP_COMPARE(3) 							 1							   LDAP_COMPARE(3)

ldap_compare - Compare value of attribute found in entry specified with DN

SYNOPSIS

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

DESCRIPTION

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

PARAMETERS

	      o $link_identifier
		- An LDAP link identifier, returned by ldap_connect(3).

	      o $dn
		- The distinguished name of an LDAP entity.

	      o $attribute
		- The attribute name.

	      o $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 #1

	      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(3) can NOT be used to compare BINARY values!

PHP Documentation Group 													   LDAP_COMPARE(3)