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()函式進行身份驗證。