ldap_first_entry()函数—用法及示例

函数名：ldap_first_entry()

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

用法：ldap_first_entry(resource $ldap_link)

说明：ldap_first_entry() 函数用于返回结果集中的第一个条目。

参数：

• $ldap_link：LDAP 连接标识符，由 ldap_connect() 返回。

返回值：

• 返回第一个条目的资源标识符，如果没有条目或者发生错误，则返回 false。

示例：

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

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

// 搜索 LDAP 目录
$ldapsearch = ldap_search($ldapconn, "dc=example,dc=com", "sn=Smith");

// 获取搜索结果中的第一个条目
$ldapentry = ldap_first_entry($ldapconn, $ldapsearch);

// 检查是否成功获取到条目
if ($ldapentry !== false) {
    // 处理条目的属性和值
    $attributes = ldap_get_attributes($ldapconn, $ldapentry);
    echo "DN: " . ldap_get_dn($ldapconn, $ldapentry) . "<br>";
    echo "CN: " . $attributes['cn'][0] . "<br>";
    echo "Email: " . $attributes['mail'][0] . "<br>";
} else {
    echo "未找到匹配的条目。";
}

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

上述示例中，我们首先创建了与 LDAP 服务器的连接，然后进行绑定操作。接下来，在指定的 LDAP 目录中搜索姓为 "Smith" 的条目，并使用 ldap_first_entry() 函数获取结果集中的第一个条目。如果成功获取到条目，我们可以使用其他 LDAP 函数（如 ldap_get_attributes() 和 ldap_get_dn()）来访问条目的属性和值。最后，关闭 LDAP 连接。