ldap_set_option()函式—用法及示例

函式名：ldap_set_option()

描述：該函式用於設定LDAP連線或操作的選項。

用法：ldap_set_option(resource $link_identifier, int $option, mixed $value) : bool

引數：

• $link_identifier：LDAP連線識別符號，由ldap_connect()函式返回。
• $option：要設定的選項，可以是以下常量之一：
  • LDAP_OPT_DEREF：設定如何處理別名。
  • LDAP_OPT_SIZELIMIT：設定返回結果的最大數目。
  • LDAP_OPT_TIMELIMIT：設定搜尋操作的最長時間。
  • LDAP_OPT_NETWORK_TIMEOUT：設定網路操作的超時時間。
  • LDAP_OPT_PROTOCOL_VERSION：設定LDAP協議的版本。
  • LDAP_OPT_REFERRALS：設定是否自動處理引用。
  • LDAP_OPT_ERROR_NUMBER：設定錯誤號。
  • LDAP_OPT_SERVER_CONTROLS：設定伺服器控制。
  • LDAP_OPT_CLIENT_CONTROLS：設定客戶端控制。
• $value：選項的值，具體取決於所設定的選項。

返回值：成功時返回 true，失敗時返回 false。

示例：

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

if ($ldapconn) {
  // 設定LDAP協議版本為3
  ldap_set_option($ldapconn, LDAP_OPT_PROTOCOL_VERSION, 3);

  // 設定超時時間為5秒
  ldap_set_option($ldapconn, LDAP_OPT_NETWORK_TIMEOUT, 5);

  // 設定搜尋結果的最大數目為100
  ldap_set_option($ldapconn, LDAP_OPT_SIZELIMIT, 100);

  // 進行LDAP操作...

  // 關閉LDAP連線
  ldap_close($ldapconn);
} else {
  echo "無法連線到LDAP伺服器";
}

以上示例展示瞭如何使用ldap_set_option()函式來設定LDAP連線的選項。首先透過ldap_connect()函式建立LDAP連線，然後使用ldap_set_option()函式分別設定LDAP協議版本、超時時間和搜尋結果的最大數目。最後進行其他LDAP操作，並最終關閉LDAP連線。請注意，示例中的LDAP伺服器地址和選項值僅供參考，實際使用時需要根據實際情況進行修改。