«
使用PHP连接LDAP服务器

时间：2008-5-31    作者：Deri    分类： 分享 

   <p>　　本文将演示如何使用PHP连接一个LDAP服务器。具体的例子是连接到一个公共的LDAP服务器并且进行搜索。这个例子模拟的是Netscape Communicator 4.*，通过自己的地址本连接到LDAP资源。</p><p>　　LDAP介绍</p><p>　　可能不少人已经听说过LDAP，但是却不了解它具体是什么东东和如何工作。在这里我将不会很详细地介绍LDAP，只是对该协议做一个简介。</p><p>　　LDAP是一个用来发布目录信息到许多不同资源的协议。通常它都作为一个集中的地址本使用，不过根据组织者的需要，它可以做得更加强大。</p><p>　　LDAP最基本的形式是一个连接数据库的标准方式。该数据库为读查询作了优化。因此它可以很快地得到查询结果，不过在其它方面，例如更新，就慢得多。要特别注意的是，LDAP通常作为一个hierarchal数据库使用，而不是一个关系数据库。因此，它的结构用树来表示比用表格好。正因为这样，就不能用SQL语句了。</p><p>　　简单说来，LDAP是一个得到关于人或者资源的集中、静态数据的快速方式。</p><p>　　要求</p><p>　　 PHPV.4（以前的版本也可以，不过没有经过测试），编译支持LADP，即使用编译时带--with-ldap公共的LDAP目录。在例子中提供了两个。</p><p>　　例子概览</p><p>　　1.设置公共LDAP服务器的信息</p><p>　　2.创建一个LDAP查询</p><p>　　3.连接到LDAP服务器</p><p>　　4.如果连接成功，处理查询</p><p>　　5.格式化输出</p><p>　　6.关闭连接</p><p>　　7.设计搜索界面的HTML表格</p><p>　　8.显示结果</p><p>　　设置公共LDAP服务器的信息</p><p>　　我们要做的第一件事情是定义所有欲搜索的LDAP服务器的信息</p><p>　　"LDAP_NAME" = 新的LDAP项目的名字</p><p>　　"LDAP_SERVER" = 新的LDAP项目的IP地址或者主机名</p><p>　　"LDAP_ROOT_DN" = 新的LDAP项目的根的辨识名</p>
<p> </p>

   <code>＜？php<br />$LDAP_NAME[0] = "Netscape Net Center";<br />$LDAP_SERVER[0] = "memberdir.netscape.com";<br />$LDAP_ROOT_DN[0] = "ou=member_directory,o=netcenter.com";<br />$LDAP_NAME[1] = "Bigfoot";<br />$LDAP_SERVER[1] = "ldap.bigfoot.com";<br />$LDAP_ROOT_DN[1] = "";<br />//如果没有选择服务器的话将它设置为0<br />if(!$SERVER_ID)<br />$SERVER_ID=0;<br />？＞</code></p><p>　　建立LDAP查询</p><p>　　前面已经提到，LDAP查询与SQL查询是不一样的。因此，语句要受到一定的限制，以下是一个基本的例子。</p><p>　　//Create Query $ldap_query = "cn=$common";</p><p>　　在我们的例子中，“cn”是我们要进行搜索的属性，而$common是由搜索的form中得到的字符串变量。LDAP的查询语句语句可使用通配符‘*’。例如‘$stanley’将可以找出‘dan stanley’。</p><p>　　连接到LDAP服务器</p><p>　　以下的函数连接到一个LDAP资源，并且将连接的识别号赋给一个变量，就好象连接到一个通常的数据库一样，例如MySQL。</p><code>＜？php<br />//连接到LDAP<br />$connect_id = ldap_connect($LDAP_SERVER[$SERVER_ID]);<br />？＞</code><p>　　在我们的例子中，“$connect_id”是连接的识别号，$LDAP_SERVER是可能的ldap服务器数组，而$SERVER_ID是由搜索表格得到的LDAP服务器变量。</p><p>　　如果连接成功，处理查询</p><p>　　 如果连接成功的话，我们将得到一个有效的LDAP连接识别号，这样我们就可以处理查询。</p><code>＜？php<br />if($connect_id)<br />{<br />//认证<br />$bind_id = ldap_bind($connect_id);<br />//执行搜索<br />$search_id = ldap_search($connect_id, $LDAP_ROOT_DN[$SERVER_ID], $ldap_query);<br />//将结果集合分配给一个数组<br />$result_array = ldap_get_entries($connect_id, $search_id);<br />}<br />else<br />{<br />//显示连接错误<br />echo "Could not connect to LDAP server: $LDAP_SERVER[$SERVER_ID]";<br />}<br />？＞</code><p>　　一旦我们与LDAP服务器建立好连接，我们就必须进行认证。PHP在连接大多数的数据库时，都是通过发送用户名和密码来进行的。不过，在LDAP中，认证是未知的，直到进行一个bind操作。在我们的例子中，“$bind_id”是绑定连接的标识符。我们是通过匿名绑定到公共的LDAP服务器的。因此，在执行ldap_bind()时，只使用连接识别号就可以了，无需其它的参数。</p>
 <p> </p>

   <p>　　在经过认证后（这里是匿名的），我们就可以使用ldap_search()函数来执行查询，产生的$search_id是我们搜索的连接识别符。</p><p>　　然后，我们使用ldap_get_entries()函数将结果集赋给$result_array变量。这样我们能够以逻辑的方式排列信息，以便显示。</p><p>　　格式化输出</p><p>　　在执行完LDAP搜索后，返回的数据是以查找的顺序排列的。不过我们在排序时没有SQL这样方便，使用ORDER BY语句就可以了。通常多数公共的LDAP目录都没有标准的大小规范。排序是基于字符的ASCII值，我们必须将字符全部格式化为小写，以便按字母的顺序输出。</p><p>　　要特别注意的是，返回的LDAP结果集是一个多维的数组。因此，我们脚本中的$result_array的结构如下：</p><code>$result_array[0]["cn"] [0] = "Dannie Stanley"<br />["dn"] [0] = "uid=dannie,dc=spinweb.net"<br />["givenname"][0] = "Dannie"<br />["sn"] [0] = "Stanley"<br />["mail"] [0] = "danSPAM@spinweb.net"<br />$result_array[1]["cn"] [0] = "Michael Reynolds"<br />["dn"] [0] = "uid=michael,dc=spinweb.net"<br />["givenname"][0] = "Michael"<br />["sn"] [0] = "Reynolds"<br />["mail"] [0] = "michaelSPAM@spinweb.net"</code><p>　　数据以这种格式存放的原因是每个属性都可能有超过一个值（象树的结构）。例如，如果我的名字是‘Dannie’，我还可以在LDAP中增加一些属性，例如：</p><code>$result_array[0]["cn"] [0] = "Dannie Stanley"<br />["dn"] [0] = "uid=dannie,dc=spinweb.net"<br />["givenname"][0] = "Dannie"<br />["givenname"][0] = "Dan"<br />["sn"] [0] = "Stanley"<br />["mail"] [0] = "danSPAM@spinweb.net"</code><p>　　在我们的搜索中，我们只关心每个属性的首个值，因此除了dn只有一个值外，其它我们只使用每个属性中序号为0的值。以下就是属性和它们含义的简单列表：</p>
 <p> </p>

   <code>"cn" = Common Name<br />"dn" = Distinguished Name<br />"givenname" = First Name<br />"sn" = Last Name<br />"mail" = Email地址<br />＜？php<br />//如果搜索成功，将结果排序<br />if($result_array)<br />{<br />for($i=0; $i {<br />$format_array[$i][0] = strtolower($result_array[$i]["cn"][0]);<br />$format_array[$i][1] = $result_array[$i]["dn"];<br />$format_array[$i][2] = strtolower($result_array[$i]["givenname"][0]);<br />$format_array[$i][3] = strtolower($result_array[$i]["sn"][0]);<br />$format_array[$i][4] = strtolower($result_array[$i]["mail"][0]);<br />}<br />//排序数组<br />sort($format_array, "SORT_STRING");<br />for($i=0; $i {<br />$cn = $format_array[$i][0];<br />$dn = $format_array[$i][1];<br />$fname = ucwords($format_array[$i][2]);<br />$lname = ucwords($format_array[$i][3]);<br />$email = $format_array[$i][4];<br />if($dn && $fname && $lname && $email)<br />{<br />$result_list .= "$fname $lname";<br />$result_list .= " <$email><br />";<br />}<br />elseif($dn && $cn && $email)<br />{<br />$result_list .= "＜A href='/"ldap://$LDAP_SERVER[$SERVER_ID]/$dn/"'＞$cn＜/A＞";<br />$result_list .= " ＜A href='/"mailto:$email/"'＞$email＜/A＞<br />";<br />}<br />}<br />}<br />else<br />{<br />echo "Result set empty for query: $ldap_query";<br />}<br />？＞</code><p>　　在我们的例子中，$format_array是我们建立的新数组，里面包括有查询的结果，并且被格式化用作输出。首先循环$result_array中的每个元素，并且将它分配给一个两维的数组用作排序。同时我们使用strtolower()函数将所有的值变为小写。</p>
 <p> </p>

   <p>　　接着，我们使用PHP自带的一个称为sort()的函数进行排序。首个参数是要排序的数组，另一个是要执行的排序类型，该类型是由PHP的文档定义的。由于我们根据字符串排序，我们使用“SORT_STRING”。</p><p>　　第三，我们循环已经格式化好的数组，并且将它分配给一个名字为$result_list的输出字符，该字符包含了HTML描述。要特别注意的是，在超链接中，我使用的是ldap的URL格式。这个格式的例子类似：HREF="ldap://ldap.domain.net/uid=dannie,dc=domain.net"。</p><p>　　关闭连接</p><p>　　现在我们所有的数据已经包含在$result_list中了，我们可以安全地关闭LDAP的连接。</p><code>＜？php<br />//关闭连接<br />ldap_close($connect_id);<br />？></code><p>　　定制搜索界面的HTML表格</p><p>　　最后，我们要定制搜索用的HTML表格，它是用来给用户执行搜索的。</p><code>//定制表格<br />echo " ＜CENTER＞＜FORM action='"$PHP_SELF"' method='"GET"'＞";<br />echo "Search in:＜SELECT name='"SERVER_ID"'＞"; //循环以建立SELECT选项 for($i=0; $i＜COUNT($LDAP_NAME); ＜br $i++)＞ echo "＜OPTION selected value='"$i"'＞".$LDAP_NAME[$i]."＜/OPTION＞"; echo "＜/SELECT＞<br />";<br />echo "Search for:＜INPUT name='"common"' type='"text"'＞";<br />echo "＜INPUT name='"lookup"' type='"submit"' value='"go"'＞<br />";<br />echo "(You can use * for wildcard searches, ex. * Stanley will find all Stanleys)<br />";<br />echo "＜/FORM＞＜/CENTER＞";<br />？＞</code><p>　　代码中的$PHP_SELF是一个全局的常量，代表的是脚本页面自身，其中的循环是用来通过我们的$LDAP_NAME变量创建SELECT选项。</p>
 <p> </p>

   <p>　　显示结果</p><p>　　现在所有的工作已经完成了，我们将打印出结果集。如果没有符合的结果，将会显示"No Results"的信息。</p><code><？php<br />//显示结果<br />if($result_list)<br />{<br />echo " ＜CENTER＞＜TABLE border='"1"' cellPadding='"10"' cellSpacing='"0"'<br />BGCOLOR="#FFFFEA" WIDTH="450"＞ ＜TBODY＞＜TR＞＜TD＞$result_list＜/TD＞＜/TR＞<br />＜/TBODY＞＜/TABLE＞＜/CENTER＞";<br />}<br />else<br />echo "No Results";<br />？＞</code><p>　　源代码</p><p>　　以下是完整的源代码，只要将它剪切并粘贴到一个HTML文档，就可以尝试一下了。</p><code>＜？php<br />$LDAP_NAME[0] = "Netscape Net Center";<br />$LDAP_SERVER[0] = "memberdir.netscape.com";<br />$LDAP_ROOT_DN[0] = "ou=member_directory,o=netcenter.com";<br />$LDAP_NAME[1] = "Bigfoot";<br />$LDAP_SERVER[1] = "ldap.bigfoot.com";<br />$LDAP_ROOT_DN[1] = "";<br />//如果没有选择服务器的话将它设置为0<br />if(!$SERVER_ID)<br />$SERVER_ID=0;<br />//建立查询<br />$ldap_query = "cn=$common";<br />//连接到LDAP<br />$connect_id = ldap_connect($LDAP_SERVER[$SERVER_ID]);<br />if($connect_id)<br />{<br />//认证<br />$bind_id = ldap_bind($connect_id);<br />//执行搜索<br />$search_id = ldap_search($connect_id, $LDAP_ROOT_DN[$SERVER_ID], $ldap_query);<br />//将结果集合分配给一个数组<br />$result_array = ldap_get_entries($connect_id, $search_id);<br />}<br />else<br />{<br />//显示连接错误<br />echo "Could not connect to LDAP server: $LDAP_SERVER[$SERVER_ID]";<br />}<br />//如果搜索成功，将结果排序<br />if($result_array)<br />{<br />for($i=0; $i {<br />$format_array[$i][0] = strtolower($result_array[$i]["cn"][0]);<br />$format_array[$i][1] = $result_array[$i]["dn"];<br />$format_array[$i][2] = strtolower($result_array[$i]["givenname"][0]);<br />$format_array[$i][3] = strtolower($result_array[$i]["sn"][0]);<br />$format_array[$i][4] = strtolower($result_array[$i]["mail"][0]);<br />}<br />//排序数组<br />sort($format_array, "SORT_STRING");<br />for($i=0; $i {<br />$cn = $format_array[$i][0];<br />$dn = $format_array[$i][1];<br />$fname = ucwords($format_array[$i][2]);<br />$lname = ucwords($format_array[$i][3]);<br />$email = $format_array[$i][4];<br />if($dn && $fname && $lname && $email)<br />{<br />$result_list .= "＜A href='/"ldap://$LDAP_SERVER[$SERVER_ID]/$dn/"'＞$fname $lname＜/A＞";<br />$result_list .= " <$email><br />";<br />}<br />elseif($dn && $cn && $email)<br />{<br />$result_list .= "＜A href='/"ldap://$LDAP_SERVER[$SERVER_ID]/$dn/"'＞$cn＜/A＞";<br />$result_list .= " <＜A href='/"mailto:$email/"'＞$email＜/A＞<br />";<br />}<br />}<br />}<br />else<br />{<br />echo "Result set empty for query: $ldap_query";<br />}<br />//关闭连接<br />ldap_close($connect_id);<br />//定制表格<br />echo " ＜CENTER＞＜FORM action='"$PHP_SELF"' method='"GET"'＞";<br />echo "Search in:＜SELECT name='"SERVER_ID"'＞"; //循环以建立SELECT选项 for($i=0; $i echo "＜OPTION selected value='"$i"'＞".$LDAP_NAME[$i]."＜/OPTION＞"; echo "＜/SELECT＞<br />";<br />echo "Search for:＜INPUT name='"common"' type='"text"'＞";<br />echo "＜INPUT name='"lookup"' type='"submit"' value='"go"'＞<br />";<br />echo "(You can use * for wildcard searches, ex. * Stanley will find all Stanleys)<br />";<br />echo "＜/FORM＞＜/CENTER＞";<br />//显示结果<br />if($result_list)<br />{<br />echo " ＜CENTER＞＜TABLE border='"1"' cellPadding='"10"' cellSpacing='"0"'<br />BGCOLOR="#FFFFEA" WIDTH="450"＞ ＜TBODY＞＜TR＞＜TD＞$result_list＜/TD＞＜/TR＞<br />＜/TBODY＞＜/TABLE＞＜/CENTER＞";<br />}<br />else<br />echo "No Results";<br />}<br />？＞</code></p>