函式名:ldap_modify_batch()
適用版本:LDAP 擴充套件庫的版本 >= 2.4.0
用法:ldap_modify_batch() 函式用於批次修改 LDAP 目錄中的條目。該函式可以一次性執行多個修改操作,如新增、修改或刪除屬性等。
語法:bool ldap_modify_batch(resource $link_identifier, string $dn, array $modifications)
引數:
- $link_identifier:一個有效的 LDAP 連線識別符號。
- $dn:要修改的條目的 DN (Distinguished Name)。
- $modifications:包含待執行的修改操作的陣列。每個修改操作都是一個關聯陣列,包含以下鍵:
- 'attrib':要修改的屬性名。
- 'values':一個陣列,包含要新增、刪除或替換的屬性值。
返回值:如果成功執行修改操作,則返回 true。如果出現錯誤,則返回 false。
示例:
// 連線到 LDAP 伺服器
$ldapconn = ldap_connect("ldap.example.com");
// 繫結到 LDAP 伺服器
ldap_bind($ldapconn, "cn=admin,dc=example,dc=com", "password");
// 定義要修改的條目的 DN
$dn = "uid=john,ou=users,dc=example,dc=com";
// 定義要執行的修改操作
$modifications = array(
array(
'attrib' => 'givenName',
'values' => array('John')
),
array(
'attrib' => 'sn',
'values' => array('Doe')
),
array(
'attrib' => 'mail',
'values' => array('[email protected]')
)
);
// 執行批次修改操作
$result = ldap_modify_batch($ldapconn, $dn, $modifications);
// 檢查修改操作是否成功
if ($result) {
echo "修改成功";
} else {
echo "修改失敗";
}
// 關閉 LDAP 連線
ldap_close($ldapconn);
上述示例中,我們首先建立與 LDAP 伺服器的連線,然後繫結到伺服器。接下來,我們定義要修改的條目的 DN,並構建要執行的修改操作的陣列。最後,我們呼叫 ldap_modify_batch() 函式來執行批次修改操作,並根據返回結果判斷修改是否成功。最後,我們關閉與 LDAP 伺服器的連線。