ldap_get_dn()函式—用法及示例

函式名：ldap_get_dn()

適用版本：PHP 4, PHP 5, PHP 7

用法：ldap_get_dn() 函式用於獲取給定的條目的 DN(Distinguished Name)。

語法：string ldap_get_dn ( resource $ldap_link, resource $ldap_entry )

引數：

• $ldap_link：LDAP連線識別符號，透過 ldap_connect() 或 ldap_bind() 函式獲得。
• $ldap_entry：LDAP 條目識別符號，透過 ldap_first_entry() 或 ldap_next_entry() 函式獲得。

返回值：如果成功，該函式返回給定條目的 DN 字串；如果失敗，則返回 FALSE。

示例：

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

// 繫結到 LDAP 目錄
$ldapbind = ldap_bind($ldapconn, "cn=admin,dc=example,dc=com", "password");

// 搜尋並獲取第一個條目
$ldapresult = ldap_search($ldapconn, "dc=example,dc=com", "cn=user1");
$ldapentry = ldap_first_entry($ldapconn, $ldapresult);

// 獲取條目的 DN
$dn = ldap_get_dn($ldapconn, $ldapentry);

// 列印 DN
echo "條目的 DN: " . $dn;

// 關閉 LDAP 連線
ldap_close($ldapconn);

上述示例中，我們首先建立了一個 LDAP 連線並繫結到目錄。然後，我們使用 ldap_search() 函式搜尋條目，並使用 ldap_first_entry() 函式獲取第一個條目。接下來，我們使用 ldap_get_dn() 函式獲取該條目的 DN，並將其列印出來。最後，我們關閉 LDAP 連線。

注意：在實際使用中，需要根據實際的 LDAP 伺服器地址、繫結賬號和密碼進行相應的修改。