<HTML ><HEAD ><TITLE >ldap_compare</TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK REL="HOME" TITLE="PHP Manual" HREF="index.html"><LINK REL="UP" TITLE="LDAP functions" HREF="ref.ldap.html"><LINK REL="PREVIOUS" TITLE="ldap_close" HREF="function.ldap-close.html"><LINK REL="NEXT" TITLE="ldap_connect" HREF="function.ldap-connect.html"><META HTTP-EQUIV="Content-type" CONTENT="text/html; charset=ISO-8859-1"></HEAD ><BODY CLASS="refentry" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#840084" ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE SUMMARY="Header navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TH COLSPAN="3" ALIGN="center" >PHP Manual</TH ></TR ><TR ><TD WIDTH="10%" ALIGN="left" VALIGN="bottom" ><A HREF="function.ldap-close.html" ACCESSKEY="P" >Prev</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ></TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="function.ldap-connect.html" ACCESSKEY="N" >Next</A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><H1 ><A NAME="function.ldap-compare" ></A >ldap_compare</H1 ><DIV CLASS="refnamediv" ><A NAME="AEN42707" ></A ><P > (PHP 4 >= 4.0.2)</P >ldap_compare -- Compare value of attribute found in entry specified with DN</DIV ><DIV CLASS="refsect1" ><A NAME="AEN42710" ></A ><H2 >Description</H2 >bool <B CLASS="methodname" >ldap_compare</B > ( resource link_identifier, string dn, string attribute, string value)<BR ></BR ><P > Returns <TT CLASS="constant" ><B >TRUE</B ></TT > if <TT CLASS="parameter" ><I >value</I ></TT > matches otherwise returns <TT CLASS="constant" ><B >FALSE</B ></TT >. Returns -1 on error. </P ><P > <B CLASS="function" >ldap_compare()</B > is used to compare <TT CLASS="parameter" ><I >value</I ></TT > of <TT CLASS="parameter" ><I >attribute</I ></TT > to value of same attribute in LDAP directory entry specified with <TT CLASS="parameter" ><I >dn</I ></TT >. </P ><P > The following example demonstrates how to check whether or not given password matches the one defined in DN specified entry. </P ><TABLE WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" CLASS="EXAMPLE" ><TR ><TD ><DIV CLASS="example" ><A NAME="AEN42737" ></A ><P ><B >Example 1. Complete example of password check</B ></P ><TABLE BORDER="0" BGCOLOR="#E0E0E0" CELLPADDING="5" ><TR ><TD ><PRE CLASS="php" ><?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."; } ?></PRE ></TD ></TR ></TABLE ></DIV ></TD ></TR ></TABLE ><DIV CLASS="warning" ><P ></P ><TABLE CLASS="warning" BORDER="1" WIDTH="100%" ><TR ><TD ALIGN="CENTER" ><B >Warning</B ></TD ></TR ><TR ><TD ALIGN="LEFT" ><P > <B CLASS="function" >ldap_compare()</B > can NOT be used to compare BINARY values! </P ></TD ></TR ></TABLE ></DIV ><DIV CLASS="note" ><BLOCKQUOTE CLASS="note" ><P ><B >Note: </B > This function was added in 4.0.2. </P ></BLOCKQUOTE ></DIV ></DIV ><DIV CLASS="NAVFOOTER" ><HR ALIGN="LEFT" WIDTH="100%"><TABLE SUMMARY="Footer navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" ><A HREF="function.ldap-close.html" ACCESSKEY="P" >Prev</A ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="index.html" ACCESSKEY="H" >Home</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" ><A HREF="function.ldap-connect.html" ACCESSKEY="N" >Next</A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" >ldap_close</TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="ref.ldap.html" ACCESSKEY="U" >Up</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" >ldap_connect</TD ></TR ></TABLE ></DIV ></BODY ></HTML >