Home/ Manual/ ldap / functions/ ldap_add

ldap_add

PHP function Edit on GitHub ✎

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

Add entries to LDAP directory

Description

ldap_add(LDAP\Connection $ldap, string $dn, array $entry, array|null $controls = null): bool

Add entries in the LDAP directory.

Parameters

ldap

Ldap

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

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

controls

Array of LDAP Controls to send with the request.

Return Values

Success

Changelog

Version	Description
7.3.0	Support for `controls` added

Examples

Complete example with authenticated bind

php

<?php
$ds = ldap_connect("localhost");  // assuming the LDAP server is on this host

if ($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";
}
?>