# ldap_mod_replace

(PHP 4, PHP 5, PHP 7)

ldap_mod_replace — Replace attribute values with new ones

### 说明

ldap_mod_replace ( resource `$link_identifier` , string `$dn` , array `$entry` [, array `$serverctrls` = array() ] ) : bool

Replaces one or more attributes from the specified `dn`. It may also add or remove attributes.

### 参数

`link_identifier`

  An LDAP link identifier, returned by ldap_connect().

`dn`

  The distinguished name of an LDAP entity.

`entry`

  An associative array listing the attributes to replace. Sending an empty array as value will remove the attribute, while sending an attribute not existing yet on this entry will add it.

`serverctrls`

  Array of LDAP Controls to send with the request.

### 返回值

成功时返回 `TRUE`， 或者在失败时返回 `FALSE`。

### 更新日志

版本 | 说明
--- | ---
7.3 | Support for `serverctrls` added

### 注释

> Note: 此函数可安全用于二进制对象。

### 参见

- ldap_mod_replace_ext() - Replace attribute values with new ones
- ldap_mod_del() - Delete attribute values from current attributes
- ldap_mod_add() - Add attribute values to current attributes
- ldap_modify_batch() - Batch and execute modifications on an LDAP entry