rename()

    boolean rename(array attributes [, string dn])
rename() will change and/or add the values specified in the attributes array at the attribute level. The format of the array passed to modify is identical to the array passed to the PHP ldap_modify()/ldap_add() function.


From the PHP ldap_add() documentation:

The ldap_add() function is used to add entries in the LDAP directory. The DN of the entry to be added is specified by dn. Array entry specifies the information about the entry. The values in the entries are indexed by individual attributes. In case of multiple values for an attribute, they are indexed using integers starting with 0.

    entry["attribute1"] = value
    entry["attribute2"][0] = value1
    entry["attribute2"][1] = value2

Example:

$ldap = new LDAP();
$ldap->cd("ou=people, dc=ypass, dc=net");
$ldap->mkdir("cn", "Bob Vila");
$ldap->cd("cn=Bob Vila, ou=people, dc=ypass, dc=net");

$attrs["cn"] = "Bob Vila";

$ldap->rename($attrs);