# ldap_mod_add

(PHP 4, PHP 5, PHP 7, PHP 8)

ldap_mod_add — Add attribute values to current attributes

### 说明

ldap_mod_add(
LDAP\Connection `$ldap`,
string `$dn`,
array `$entry`,
?array `$controls` = `null`
): bool

Adds one or more attribute values to the specified `dn`. To add a whole new object see ldap_add() function.

### 参数

`ldap`

  通过 ldap_connect() 返回的 LDAP\Connection 实例。

`dn`

  The distinguished name of an LDAP entity.

`entry`

  An associative array listing the attirbute values to add. If an attribute was not existing yet it will be added. If an attribute is existing you can only add values to it if it supports multiple values.

`controls`

  Array of LDAP Controls to send with the request.

### 返回值

成功时返回 `true`， 或者在失败时返回 `false`。

### 更新日志

版本 | 说明
--- | ---
8.1.0 | 现在 `ldap` 参数接受 LDAP\Connection 实例，之前接受有效的 `ldap link` resource。
8.0.0 | `controls` is nullable now; previously, it defaulted to `[]`.
7.3.0 | Support for `controls` added

### 注释

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

### 参见

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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open