函式名:ldap_connect()
適用版本:PHP 4, PHP 5, PHP 7
函式描述:ldap_connect()函式用於建立與LDAP伺服器的連線。
語法:resource ldap_connect ([ string $hostname = NULL [, int $port = 389 ]] )
引數:
- hostname(可選):LDAP伺服器的主機名或IP地址。如果未提供主機名,則會使用php.ini檔案中的ldap.server配置項的值。預設為NULL。
- port(可選):LDAP伺服器的埠號。預設為389。
返回值:成功時返回一個LDAP連線識別符號(resource),失敗時返回FALSE。
示例:
- 建立與LDAP伺服器的連線:
$ldapconn = ldap_connect("ldap.example.com");
if (!$ldapconn) {
echo "無法連線到LDAP伺服器";
exit;
}
- 使用指定埠號建立連線:
$ldapconn = ldap_connect("ldap.example.com", 636);
if (!$ldapconn) {
echo "無法連線到LDAP伺服器";
exit;
}
- 使用php.ini中的配置項建立連線:
$ldapconn = ldap_connect();
if (!$ldapconn) {
echo "無法連線到LDAP伺服器";
exit;
}
注意事項:
- ldap_connect()函式只是建立與LDAP伺服器的連線,不會驗證使用者名稱和密碼。如果需要進行身份驗證,可以使用ldap_bind()函式。
- ldap_connect()函式在成功建立連線後返回一個連線識別符號,可以在後續的LDAP操作中使用該識別符號。