# ldap_rename

(PHP 4 >= 4.0.5, PHP 5, PHP 7)

ldap_rename — Modify the name of an entry

### 说明

ldap_rename ( resource `$link_identifier` , string `$dn` , string `$newrdn` , string `$newparent` , bool `$deleteoldrdn` [, array `$serverctrls` = array() ] ) : bool

The entry specified by `dn` is renamed/moved.

### 参数

`link_identifier`

  An LDAP link identifier, returned by ldap_connect().

`dn`

  The distinguished name of an LDAP entity.

`newrdn`

  The new RDN.

`newparent`

  The new parent/superior entry.

`deleteoldrdn`

  If `TRUE` the old RDN value(s) is removed, else the old RDN value(s) is retained as non-distinguished values of the entry.

`serverctrls`

  Array of LDAP Controls to send with the request.

### 返回值

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

### 更新日志

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

### 注释

> Note:

> This function currently only works with LDAPv3. You may have to use ldap_set_option() prior to binding to use LDAPv3. This function is only available when using OpenLDAP 2.x.x OR Netscape Directory SDK x.x.

### 参见

- ldap_rename_ext() - Modify the name of an entry
- ldap_modify() - 别名 ldap_mod_replace