ldap_get_values()函式—用法及示例

函式：ldap_get_values()

適用版本：PHP 4 >= 4.0.2, PHP 5, PHP 7

用法：ldap_get_values(resource $link_identifier, resource $result_entry_identifier, string $attribute)

說明：ldap_get_values() 函式用於獲取一個結果項的特定屬性值。結果項是透過 ldap_search() 或 ldap_list() 函式返回的。

引數：

• $link_identifier: LDAP 連線識別符號，透過 ldap_connect() 函式獲得。
• $result_entry_identifier: 結果項識別符號，透過 ldap_search() 或 ldap_list() 函式獲得。
• $attribute: 要獲取的屬性名稱。

返回值：如果成功，該函式返回一個包含指定屬性值的陣列。如果失敗，返回 FALSE。

示例：

// 連線到 LDAP 伺服器
$ldapconn = ldap_connect("ldap.example.com");

if ($ldapconn) {
   // 繫結到 LDAP 伺服器
   $ldapbind = ldap_bind($ldapconn, "cn=admin,dc=example,dc=com", "password");

   if ($ldapbind) {
      // 搜尋 LDAP 目錄
      $result = ldap_search($ldapconn, "dc=example,dc=com", "uid=johndoe");

      // 獲取第一個結果項
      $entry = ldap_first_entry($ldapconn, $result);

      // 獲取 "cn" 屬性的值
      $values = ldap_get_values($ldapconn, $entry, "cn");

      // 列印屬性值
      for ($i = 0; $i < $values['count']; $i++) {
         echo "cn: " . $values[$i] . "<br>";
      }
   } else {
      echo "LDAP 繫結失敗...";
   }

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

在上面的示例中，我們首先使用 ldap_connect() 函式連線到 LDAP 伺服器。然後，透過 ldap_bind() 函式繫結到伺服器。接下來，使用 ldap_search() 函式搜尋 LDAP 目錄，並使用 ldap_first_entry() 函式獲取第一個結果項。最後，使用 ldap_get_values() 函式獲取結果項的 "cn" 屬性值，並使用迴圈列印出來。請注意，這只是一個簡單的示例，實際應用中可能需要更復雜的搜尋和處理邏輯。