函式名:ldap_mod_add()
適用版本:PHP 4, PHP 5, PHP 7
用法:ldap_mod_add() 函式用於向指定的LDAP目錄項中新增一個或多個屬性。
語法:bool ldap_mod_add(resource $link_identifier, string $dn, array $entry)
引數:
- $link_identifier:LDAP 連線識別符號,透過 ldap_connect() 返回的資源。
- $dn:要新增屬性的目錄項的 DN (Distinguished Name)。
- $entry:包含要新增的屬性的關聯陣列。陣列的鍵是屬性名,值是屬性的值。可以使用多個鍵值對來新增多個屬性。
返回值:成功時返回 true,失敗時返回 false。
示例:
<?php
// 連線到 LDAP 伺服器
$ldapconn = ldap_connect("ldap.example.com");
// 繫結到 LDAP 伺服器
$ldapbind = ldap_bind($ldapconn, "cn=admin,dc=example,dc=com", "password");
// 準備要新增的屬性
$entry = array(
"cn" => "John Doe",
"sn" => "Doe",
"mail" => "[email protected]",
"objectClass" => "person"
);
// 新增屬性到目錄項
$add = ldap_mod_add($ldapconn, "uid=johndoe,ou=users,dc=example,dc=com", $entry);
if ($add) {
echo "屬性新增成功";
} else {
echo "屬性新增失敗";
}
// 關閉 LDAP 連線
ldap_close($ldapconn);
?>
以上示例中,我們首先連線到 LDAP 伺服器,然後繫結到伺服器。接著,我們準備要新增的屬性,並使用 ldap_mod_add() 函式將屬性新增到指定的目錄項中。最後,我們根據函式的返回值判斷屬性新增是否成功,並關閉 LDAP 連線。