Php/docs/function.ldap-add

From Get docs

ldap_add

(PHP 4, PHP 5, PHP 7)

ldap_addAdd entries to LDAP directory


Description

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

Add entries in the LDAP directory.


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 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.

<?php$entry["attribute1"] = "value";$entry["attribute2"][0] = "value1";$entry["attribute2"][1] = "value2";?>

serverctrls

Array of LDAP Controls to send with the request.


Return Values

Returns TRUE on success or FALSE on failure.


Changelog

Version Description
7.3 Support for serverctrls added


Examples

Example #1 Complete example with authenticated bind

<?php$ds = ldap_connect("localhost");  // assuming the LDAP server is on this hostif ($ds) {    // bind with appropriate dn to give update access    $r = ldap_bind($ds, "cn=root, o=My Company, c=US", "secret");    // prepare data    $info["cn"] = "John Jones";    $info["sn"] = "Jones";    $info["objectclass"] = "person";    // add data to directory    $r = ldap_add($ds, "cn=John Jones, o=My Company, c=US", $info);    ldap_close($ds);} else {    echo "Unable to connect to LDAP server";}?>

Notes

Note:

This function is

binary-safe.

See Also