本文作者是一位开源理念的坚定支持者,所以本文虽然不是软件,但是遵照开源的精神发布。
本文作者十分愿意与他人分享劳动成果,如果你对我的其他翻译作品或者技术文章有兴趣,可以在如下位置查看现有的作品集:
由于作者水平有限,因此不能保证作品内容准确无误。如果你发现了作品中的错误(哪怕是错别字也好),请来信指出,任何提高作品质量的建议我都将虚心接纳。
LDAP(Lightweight Directory Access Protocol)的意思是"轻量级目录访问协议",是一个用于访问"目录服务器"(Directory Servers)的协议。这里所谓的"目录"是指一种按照树状结构存储信息的数据库。这个概念和硬盘上的目录结构类似,不过LDAP的"根目录"必须是"The world",并且其一级子目录必须是"countries"。二级目录通常包含有公司(companies)、组织(organisations)、地点(places)等等……相应的三级子目录通常会包含人员(people)、设备(equipment)、文档(documents)等等……
当你引用硬盘上的文件时,通常是这样的:
/usr/local/myapp/docs正斜杠(/)在这里表示级别分界线,并且从左向右阅读。
而在LDAP中则通过"distinguished name"(简称"dn")来表示文件,通常像下面这样:
cn=John Smith,ou=Accounts,o=My Company,c=US逗号(,)在这里表示级别分界线,并且从右向左阅读。上述dn可以理解为:
country = US organization = My Company organizationalUnit = Accounts commonName = John Smith术语对比:
dn,entry 目录/文件 attribute 属性 value 值与硬盘目录一样,目录服务器上的目录结构也没有任何限制,这就意味着你必须了解一些服务器的结构信息才能写程序。
更多关于LDAP的信息可以在下面两个URL找到:
Mozilla
OpenLDAP Project
PHP默认并不启用LDAP支持,PHP的LDAP模块依赖于OpenLDAP或bind9.net提供的客户端LDAP库,你必须在编译的时候使用 --with-ldap[=DIR] 才行,如果你想要SASL支持,那还必须使用 --with-ldap-sasl[=DIR] 选项,而且你的系统中必须有 sasl.h 头文件才行。
LDAP模块的行为受下面的配置指令的影响
指令 | 数据类型 | 作用域 | 默认值 | 解释 |
---|---|---|---|---|
ldap.max_links | 整数 | PHP_INI_SYSTEM | -1 | 每进程允许的最大LDAP连接数。"-1"表示无限制。 |
在进行LDAP编程之前,你必须知道目录服务器的下列信息:
一般的LDAP编程步骤如下:
resource ldap_connect ([ string $hostname = NULL [, int $port = 389 ]] )
使用指定的主机名($hostname)和端口($port)连接到LDAP服务器。
连接成功则返回一个LDAP连接标识符,连接失败则返回 FALSE 。
如果服务器端是 OpenLDAP 2.x.x 或更高版本,那么此函数将始终返回一个LDAP连接标识符,而永远不会失败。实际的连接动作将在接下来调用 ldap_* 函数[通常是ldap_bind()]时执行。
如果不带任何参数调用此函数,则返回上一次连接已经打开的连接标识符。
bool ldap_bind ( resource $link_identifier [, string $bind_rdn = NULL [, string $bind_password = NULL ]] )
使用指定的RDN($bind_rdn)和密码($bind_password)绑定到LDAP目录。
绑定成功返回 TRUE 否则返回 FALSE 。
string ldap_error ( resource $link_identifier )
检索LDAP操作的错误信息。
返回指定的连接标识符上最近一次LDAP操作的错误信息。
bool ldap_get_option ( resource $link_identifier , int $option , mixed &$retval )
bool ldap_set_option ( resource $link_identifier , int $option , mixed $newval )
获取/设置LDAP选项的值。
获取/设置成功返回 TRUE 否则返回 FALSE 。
bool ldap_add ( resource $link_identifier , string $dn , array $entry )
bool ldap_delete ( resource $link_identifier , string $dn )
在LDAP目录中添加/删除一个项。
$entry["bool"]='TRUE'; $entry["int"]='-3'; $entry["mail"]='jonj@example.com'; $entree["tel"][0] = "2222222"; $entree["tel"][1] = "4444444";
添加/删除成功返回 TRUE 否则返回 FALSE 。
mixed ldap_compare ( resource $link_identifier , string $dn , string $attribute , string $value )
检查LDAP目录项$dn的$attribute属性值与给定的$value是否相同。注意:不能用来比较二进制数据!
相同返回 TRUE ,不同返回 FALSE ,遇见错误返回 -1
resource ldap_read ( resource $link_identifier , string $base_dn , string $filter [, array $attributes [, int $attrsonly [, int $sizelimit [, int $timelimit [, int $deref ]]]]] )
resource ldap_list ( resource $link_identifier , string $base_dn , string $filter [, array $attributes [, int $attrsonly [, int $sizelimit [, int $timelimit [, int $deref ]]]]] )
resource ldap_search ( resource $link_identifier , string $base_dn , string $filter [, array $attributes [, int $attrsonly [, int $sizelimit [, int $timelimit [, int $deref ]]]]] )
使用指定的过滤器搜索LDAP目录。三个函数的不同之处在于搜索范围不同:
read仅搜索$base_dn本身(LDAP_SCOPE_BASE),相当于从目录中读取一个条目(entry)。
list仅搜索$base_dn的下一级对象(LDAP_SCOPE_ONELEVEL),不包含本身,相当于"ls"命令。
search搜索$base_dn本身及其所有子对象(LDAP_SCOPE_SUBTREE),相当于搜索整个目录树。
成功返回一个结果集的资源描述符,通常被其他函数以$result_identifier引用,失败返回FALSE
array ldap_get_entries ( resource $link_identifier , resource $result_identifier )
返回前一次搜索操作的结果集,包括每一项的属性和属性值。
成功返回一个包含结果集的多维数组,失败返回FALSE。
注意:结果集数组的属性索引将被转换成小写字母(对于LDAP来说属性是大小写无关的)。
结果集数组的结构如下所示:
return_value["count"] = 结果集中的条目总数(包含第零项) return_value[0] : 对结果集中第零项(一般不同于后面的常规项)的详细信息的引用 return_value[i]["dn"] = 结果集中第 i 个条目的 DN return_value[i]["count"] = 结果集中第 i 个条目的属性数量 return_value[i][j] = 结果集中第 i 个条目的第 j 个属性 return_value[i]["attribute"]["count"] = 结果集中第 i 个条目的"attribute"属性的值的数量 return_value[i]["attribute"][j] = 结果集中第 i 个条目的"attribute"属性的第 j 个值
bool ldap_unbind ( resource $link_identifier )
解除绑定,也就是关闭LDAP连接。
成功返回 TRUE 否则返回 FALSE 。