ldap_modify_batchBatch and execute modifications on an LDAP entry
&reftitle.description;
boolldap_modify_batchresourcelink_identifierstringdnarrayentryarrayserverctrlsarray()
Modifies an existing entry in the LDAP directory. Allows detailed
specification of the modifications to perform.
&reftitle.parameters;
link_identifier
An LDAP link identifier, returned by ldap_connect.
dn
The distinguished name of an LDAP entity.
entry
An array that specifies the modifications to make. Each entry in this
array is an associative array with two or three keys:
attrib maps to the name of the attribute to modify,
modtype maps to the type of modification to perform,
and (depending on the type of modification) values
maps to an array of attribute values relevant to the modification.
Possible values for modtype include:
LDAP_MODIFY_BATCH_ADD
Each value specified through values is added (as
an additional value) to the attribute named by
attrib.
LDAP_MODIFY_BATCH_REMOVE
Each value specified through values is removed
from the attribute named by attrib. Any value of
the attribute not contained in the values array
will remain untouched.
LDAP_MODIFY_BATCH_REMOVE_ALL
All values are removed from the attribute named by
attrib. A values entry must
not be provided.
LDAP_MODIFY_BATCH_REPLACE
All current values of the attribute named by
attrib are replaced with the values specified
through values.
Note that any value for attrib must be a string, any
value for values must be an array of strings, and
any value for modtype must be one of the
LDAP_MODIFY_BATCH_* constants listed above.
serverctrls
Array of LDAP Controls to send with the request.
&reftitle.returnvalues;
&return.success;
&reftitle.changelog;
&Version;&Description;7.3
Support for serverctrls added
&reftitle.examples;
Add a telephone number to a contact
"telephoneNumber",
"modtype" => LDAP_MODIFY_BATCH_ADD,
"values" => ["+1 555 555 1717"],
],
];
ldap_modify_batch($connection, $dn, $modifs);
?>
]]>
Rename a user
"sn",
"modtype" => LDAP_MODIFY_BATCH_REPLACE,
"values" => ["Smith-Jones"],
],
[
"attrib" => "givenName",
"modtype" => LDAP_MODIFY_BATCH_REPLACE,
"values" => ["Jack"],
],
];
ldap_modify_batch($connection, $dn, $modifs);
ldap_rename($connection, $dn, "cn=Jack Smith-Jones", NULL, TRUE);
?>
]]>
Add two e-mail addresses to a user
"mail",
"modtype" => LDAP_MODIFY_BATCH_ADD,
"values" => [
"jack.smith@example.com",
"jack.smith-jones@example.com",
],
],
];
ldap_modify_batch($connection, $dn, $modifs);
?>
]]>
Change a user's password
"userPassword",
"modtype" => LDAP_MODIFY_BATCH_REMOVE,
"values" => ["Tr0ub4dor&3"],
],
[
"attrib" => "userPassword",
"modtype" => LDAP_MODIFY_BATCH_ADD,
"values" => ["correct horse battery staple"],
],
];
ldap_modify_batch($connection, $dn, $modifs);
?>
]]>
Change a user's password (Active Directory)
"unicodePwd",
"modtype" => LDAP_MODIFY_BATCH_REMOVE,
"values" => [adifyPw("Tr0ub4dor&3")],
],
[
"attrib" => "unicodePwd",
"modtype" => LDAP_MODIFY_BATCH_ADD,
"values" => [adifyPw("correct horse battery staple")],
],
];
ldap_modify_batch($connection, $dn, $modifs);
]]>