[函数]ldap_get_dn()函数—用法及示例

函数名：ldap_get_dn()

适用版本：PHP 4, PHP 5, PHP 7

用法：ldap_get_dn() 函数用于获取给定的条目的 DN(Distinguished Name)。

语法：string ldap_get_dn ( resource $ldap_link, resource $ldap_entry )

参数：

• $ldap_link：LDAP连接标识符，通过 ldap_connect() 或 ldap_bind() 函数获得。
• $ldap_entry：LDAP 条目标识符，通过 ldap_first_entry() 或 ldap_next_entry() 函数获得。

返回值：如果成功，该函数返回给定条目的 DN 字符串；如果失败，则返回 FALSE。

示例：

// 创建 LDAP 连接
$ldapconn = ldap_connect("ldap.example.com");

// 绑定到 LDAP 目录
$ldapbind = ldap_bind($ldapconn, "cn=admin,dc=example,dc=com", "password");

// 搜索并获取第一个条目
$ldapresult = ldap_search($ldapconn, "dc=example,dc=com", "cn=user1");
$ldapentry = ldap_first_entry($ldapconn, $ldapresult);

// 获取条目的 DN
$dn = ldap_get_dn($ldapconn, $ldapentry);

// 打印 DN
echo "条目的 DN: " . $dn;

// 关闭 LDAP 连接
ldap_close($ldapconn);

上述示例中，我们首先创建了一个 LDAP 连接并绑定到目录。然后，我们使用 ldap_search() 函数搜索条目，并使用 ldap_first_entry() 函数获取第一个条目。接下来，我们使用 ldap_get_dn() 函数获取该条目的 DN，并将其打印出来。最后，我们关闭 LDAP 连接。

注意：在实际使用中，需要根据实际的 LDAP 服务器地址、绑定账号和密码进行相应的修改。