<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <HTML ><HEAD ><TITLE >ldap_compare</TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK REL="HOME" TITLE="Manual PHP" 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-2"></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" >Manual PHP</TH ></TR ><TR ><TD WIDTH="10%" ALIGN="left" VALIGN="bottom" ><A HREF="function.ldap-close.html" ACCESSKEY="P" >Înapoi</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" >Înainte</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="AEN48261" ></A ><P > (PHP 4 >= 4.0.2, PHP 5)</P >ldap_compare -- Compare value of attribute found in entry specified with DN</DIV ><DIV CLASS="refsect1" ><A NAME="AEN48264" ></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 <VAR CLASS="parameter" >value</VAR > 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 <VAR CLASS="parameter" >value</VAR > of <VAR CLASS="parameter" >attribute</VAR > to value of same attribute in LDAP directory entry specified with <VAR CLASS="parameter" >dn</VAR >. </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="AEN48291" ></A ><P ><B >Exemplu 1. Complete example of password check</B ></P ><TABLE BORDER="0" BGCOLOR="#E0E0E0" CELLPADDING="5" ><TR ><TD ><code><font color="#000000"> <font color="#0000BB"><?php<br /><br />$ds</font><font color="#007700">=</font><font color="#0000BB">ldap_connect</font><font color="#007700">(</font><font color="#DD0000">"localhost"</font><font color="#007700">); </font><font color="#FF8000">// assuming the LDAP server is on this host<br /> <br /></font><font color="#007700">if (</font><font color="#0000BB">$ds</font><font color="#007700">) {<br /><br /> </font><font color="#FF8000">// bind <br /> </font><font color="#007700">if (</font><font color="#0000BB">ldap_bind</font><font color="#007700">(</font><font color="#0000BB">$ds</font><font color="#007700">)) {<br /><br /> </font><font color="#FF8000">// prepare data<br /> </font><font color="#0000BB">$dn </font><font color="#007700">= </font><font color="#DD0000">"cn=Matti Meikku, ou=My Unit, o=My Company, c=FI"</font><font color="#007700">;<br /> </font><font color="#0000BB">$value </font><font color="#007700">= </font><font color="#DD0000">"secretpassword"</font><font color="#007700">;<br /> </font><font color="#0000BB">$attr </font><font color="#007700">= </font><font color="#DD0000">"password"</font><font color="#007700">; <br /><br /> </font><font color="#FF8000">// compare value<br /> </font><font color="#0000BB">$r</font><font color="#007700">=</font><font color="#0000BB">ldap_compare</font><font color="#007700">(</font><font color="#0000BB">$ds</font><font color="#007700">, </font><font color="#0000BB">$dn</font><font color="#007700">, </font><font color="#0000BB">$attr</font><font color="#007700">, </font><font color="#0000BB">$value</font><font color="#007700">);<br /><br /> if (</font><font color="#0000BB">$r </font><font color="#007700">=== -</font><font color="#0000BB">1</font><font color="#007700">) {<br /> echo </font><font color="#DD0000">"Error: " </font><font color="#007700">. </font><font color="#0000BB">ldap_error</font><font color="#007700">(</font><font color="#0000BB">$ds</font><font color="#007700">);<br /> } elseif (</font><font color="#0000BB">$r </font><font color="#007700">=== </font><font color="#0000BB">true</font><font color="#007700">) {<br /> echo </font><font color="#DD0000">"Password correct."</font><font color="#007700">;<br /> } elseif (</font><font color="#0000BB">$r </font><font color="#007700">=== </font><font color="#0000BB">false</font><font color="#007700">) {<br /> echo </font><font color="#DD0000">"Wrong guess! Password incorrect."</font><font color="#007700">;<br /> }<br /><br /> } else {<br /> echo </font><font color="#DD0000">"Unable to bind to LDAP server."</font><font color="#007700">;<br /> } <br /><br /> </font><font color="#0000BB">ldap_close</font><font color="#007700">(</font><font color="#0000BB">$ds</font><font color="#007700">);<br /><br />} else {<br /> echo </font><font color="#DD0000">"Unable to connect to LDAP server."</font><font color="#007700">;<br />}<br /></font><font color="#0000BB">?></font> </font> </code></TD ></TR ></TABLE ></DIV ></TD ></TR ></TABLE ><DIV CLASS="warning" ><P ></P ><TABLE CLASS="warning" BORDER="1" WIDTH="100%" ><TR ><TD ALIGN="CENTER" ><B >Avertisment</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 >Notã: </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" >Înapoi</A ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="index.html" ACCESSKEY="H" >Acasã</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" ><A HREF="function.ldap-connect.html" ACCESSKEY="N" >Înainte</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" >Sus</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" >ldap_connect</TD ></TR ></TABLE ></DIV ></BODY ></HTML >