ldap_add()函式—用法及示例

函式名稱：ldap_add()

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

函式描述：ldap_add()函式用於將一個新的條目新增到LDAP目錄中。

語法：bool ldap_add ( resource $link_identifier , string $dn , array $entry [, array $controls ] )

引數：

• $link_identifier：LDAP連線識別符號，透過ldap_connect()函式獲取。
• $dn：要新增的條目的唯一名稱（Distinguished Name）。
• $entry：要新增的條目的屬性和值的關聯陣列。
• $controls（可選）：LDAP控制器陣列，用於指定額外的操作和約束。

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

示例：

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

// 繫結到LDAP伺服器（使用管理員憑證）
$ldapbind = ldap_bind($ldapconn, "cn=admin,dc=example,dc=com", "password") or die("無法繫結到LDAP伺服器");

// 準備要新增的條目的屬性和值
$entry = array();
$entry["cn"] = "John Doe";
$entry["sn"] = "Doe";
$entry["mail"] = "[email protected]";
$entry["objectclass"] = "inetOrgPerson";

// 新增條目到LDAP目錄
$dn = "cn=John Doe,ou=People,dc=example,dc=com";
$result = ldap_add($ldapconn, $dn, $entry);

// 檢查新增結果
if ($result) {
    echo "條目成功新增到LDAP目錄";
} else {
    echo "新增條目失敗： " . ldap_error($ldapconn);
}

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

上述示例演示瞭如何使用ldap_add()函式將一個新條目新增到LDAP目錄中。首先，使用ldap_connect()函式建立與LDAP伺服器的連線。然後，使用ldap_bind()函式進行身份驗證。接下來，建立一個包含要新增的條目屬性和值的關聯陣列。然後，指定要新增條目的唯一名稱（Distinguished Name）。最後，呼叫ldap_add()函式將條目新增到LDAP目錄中。如果新增成功，將顯示一條成功訊息，否則將顯示錯誤訊息。最後，使用ldap_close()函式關閉LDAP連線。