<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <head> <meta http-equiv="content-type" content="text/html; charset=UTF-8"> <title>Basic usage</title> </head> <body><div class="manualnavbar" style="text-align: center;"> <div class="prev" style="text-align: left; float: left;"><a href="ldap.examples.html">Examples</a></div> <div class="next" style="text-align: right; float: right;"><a href="ref.ldap.html">LDAP Functions</a></div> <div class="up"><a href="ldap.examples.html">Examples</a></div> <div class="home"><a href="index.html">PHP Manual</a></div> </div><hr /><div id="ldap.examples-basic" class="section"> <h2 class="title">Basic usage</h2> <p class="para"> Retrieve information for all entries where the surname starts with "S" from a directory server, displaying an extract with name and email address. </p> <div class="example" id="example-4386"> <p><strong>Example #1 LDAP search example</strong></p> <div class="example-contents"> <div class="phpcode"><code><span style="color: #000000"> <span style="color: #0000BB"><?php<br /></span><span style="color: #FF8000">// basic sequence with LDAP is connect, bind, search, interpret search<br />// result, close connection<br /><br /></span><span style="color: #007700">echo </span><span style="color: #DD0000">"<h3>LDAP query test</h3>"</span><span style="color: #007700">;<br />echo </span><span style="color: #DD0000">"Connecting ..."</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$ds</span><span style="color: #007700">=</span><span style="color: #0000BB">ldap_connect</span><span style="color: #007700">(</span><span style="color: #DD0000">"localhost"</span><span style="color: #007700">); </span><span style="color: #FF8000">// must be a valid LDAP server!<br /></span><span style="color: #007700">echo </span><span style="color: #DD0000">"connect result is " </span><span style="color: #007700">. </span><span style="color: #0000BB">$ds </span><span style="color: #007700">. </span><span style="color: #DD0000">"<br />"</span><span style="color: #007700">;<br /><br />if (</span><span style="color: #0000BB">$ds</span><span style="color: #007700">) { <br /> echo </span><span style="color: #DD0000">"Binding ..."</span><span style="color: #007700">; <br /> </span><span style="color: #0000BB">$r</span><span style="color: #007700">=</span><span style="color: #0000BB">ldap_bind</span><span style="color: #007700">(</span><span style="color: #0000BB">$ds</span><span style="color: #007700">); </span><span style="color: #FF8000">// this is an "anonymous" bind, typically<br /> // read-only access<br /> </span><span style="color: #007700">echo </span><span style="color: #DD0000">"Bind result is " </span><span style="color: #007700">. </span><span style="color: #0000BB">$r </span><span style="color: #007700">. </span><span style="color: #DD0000">"<br />"</span><span style="color: #007700">;<br /><br /> echo </span><span style="color: #DD0000">"Searching for (sn=S*) ..."</span><span style="color: #007700">;<br /> </span><span style="color: #FF8000">// Search surname entry<br /> </span><span style="color: #0000BB">$sr</span><span style="color: #007700">=</span><span style="color: #0000BB">ldap_search</span><span style="color: #007700">(</span><span style="color: #0000BB">$ds</span><span style="color: #007700">, </span><span style="color: #DD0000">"o=My Company, c=US"</span><span style="color: #007700">, </span><span style="color: #DD0000">"sn=S*"</span><span style="color: #007700">); <br /> echo </span><span style="color: #DD0000">"Search result is " </span><span style="color: #007700">. </span><span style="color: #0000BB">$sr </span><span style="color: #007700">. </span><span style="color: #DD0000">"<br />"</span><span style="color: #007700">;<br /><br /> echo </span><span style="color: #DD0000">"Number of entries returned is " </span><span style="color: #007700">. </span><span style="color: #0000BB">ldap_count_entries</span><span style="color: #007700">(</span><span style="color: #0000BB">$ds</span><span style="color: #007700">, </span><span style="color: #0000BB">$sr</span><span style="color: #007700">) . </span><span style="color: #DD0000">"<br />"</span><span style="color: #007700">;<br /><br /> echo </span><span style="color: #DD0000">"Getting entries ...<p>"</span><span style="color: #007700">;<br /> </span><span style="color: #0000BB">$info </span><span style="color: #007700">= </span><span style="color: #0000BB">ldap_get_entries</span><span style="color: #007700">(</span><span style="color: #0000BB">$ds</span><span style="color: #007700">, </span><span style="color: #0000BB">$sr</span><span style="color: #007700">);<br /> echo </span><span style="color: #DD0000">"Data for " </span><span style="color: #007700">. </span><span style="color: #0000BB">$info</span><span style="color: #007700">[</span><span style="color: #DD0000">"count"</span><span style="color: #007700">] . </span><span style="color: #DD0000">" items returned:<p>"</span><span style="color: #007700">;<br /><br /> for (</span><span style="color: #0000BB">$i</span><span style="color: #007700">=</span><span style="color: #0000BB">0</span><span style="color: #007700">; </span><span style="color: #0000BB">$i</span><span style="color: #007700"><</span><span style="color: #0000BB">$info</span><span style="color: #007700">[</span><span style="color: #DD0000">"count"</span><span style="color: #007700">]; </span><span style="color: #0000BB">$i</span><span style="color: #007700">++) {<br /> echo </span><span style="color: #DD0000">"dn is: " </span><span style="color: #007700">. </span><span style="color: #0000BB">$info</span><span style="color: #007700">[</span><span style="color: #0000BB">$i</span><span style="color: #007700">][</span><span style="color: #DD0000">"dn"</span><span style="color: #007700">] . </span><span style="color: #DD0000">"<br />"</span><span style="color: #007700">;<br /> echo </span><span style="color: #DD0000">"first cn entry is: " </span><span style="color: #007700">. </span><span style="color: #0000BB">$info</span><span style="color: #007700">[</span><span style="color: #0000BB">$i</span><span style="color: #007700">][</span><span style="color: #DD0000">"cn"</span><span style="color: #007700">][</span><span style="color: #0000BB">0</span><span style="color: #007700">] . </span><span style="color: #DD0000">"<br />"</span><span style="color: #007700">;<br /> echo </span><span style="color: #DD0000">"first email entry is: " </span><span style="color: #007700">. </span><span style="color: #0000BB">$info</span><span style="color: #007700">[</span><span style="color: #0000BB">$i</span><span style="color: #007700">][</span><span style="color: #DD0000">"mail"</span><span style="color: #007700">][</span><span style="color: #0000BB">0</span><span style="color: #007700">] . </span><span style="color: #DD0000">"<br /><hr />"</span><span style="color: #007700">;<br /> }<br /><br /> echo </span><span style="color: #DD0000">"Closing connection"</span><span style="color: #007700">;<br /> </span><span style="color: #0000BB">ldap_close</span><span style="color: #007700">(</span><span style="color: #0000BB">$ds</span><span style="color: #007700">);<br /><br />} else {<br /> echo </span><span style="color: #DD0000">"<h4>Unable to connect to LDAP server</h4>"</span><span style="color: #007700">;<br />}<br /></span><span style="color: #0000BB">?></span> </span> </code></div> </div> </div> </div><hr /><div class="manualnavbar" style="text-align: center;"> <div class="prev" style="text-align: left; float: left;"><a href="ldap.examples.html">Examples</a></div> <div class="next" style="text-align: right; float: right;"><a href="ref.ldap.html">LDAP Functions</a></div> <div class="up"><a href="ldap.examples.html">Examples</a></div> <div class="home"><a href="index.html">PHP Manual</a></div> </div></body></html>