ldap_control_paged_result()函数—用法及示例

函数名：ldap_control_paged_result()

适用版本：PHP 5, PHP 7

用法：ldap_control_paged_result() 函数用于启用或禁用分页结果控制。它允许在LDAP搜索操作中使用分页来限制返回的结果数量。

语法：bool ldap_control_paged_result(resource $link_identifier, int $pagesize [, bool $iscritical])

参数：

• $link_identifier：一个有效的 LDAP 连接标识符。
• $pagesize：每个结果页应包含的条目数。
• $iscritical（可选）：如果设置为 true，则表示分页结果控制是关键的，如果服务器不支持分页则搜索操作将被中止。默认为 false。

返回值：成功时返回 true，失败时返回 false。

示例：

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

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

// 启用分页结果控制
ldap_control_paged_result($ldapconn, 10); 

// 执行搜索操作
$result = ldap_search($ldapconn, "dc=example,dc=com", "(&(objectClass=user)(cn=*))");

// 获取搜索结果
$entries = ldap_get_entries($ldapconn, $result);

// 遍历搜索结果
for ($i = 0; $i < $entries["count"]; $i++) {
    echo "DN: " . $entries[$i]["dn"] . "<br/>";
    echo "CN: " . $entries[$i]["cn"][0] . "<br/>";
    echo "Email: " . $entries[$i]["mail"][0] . "<br/><br/>";
}

// 禁用分页结果控制
ldap_control_paged_result($ldapconn, 0);

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

以上示例演示了如何使用ldap_control_paged_result()函数启用分页结果控制，搜索并遍历LDAP目录中的用户条目，并在每页返回的结果中限制为10个条目。最后，禁用分页结果控制并关闭LDAP连接。

请注意，要使用ldap_control_paged_result()函数，必须先使用ldap_connect()函数建立LDAP连接，并使用ldap_bind()函数进行身份验证。