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 連線。