Добавляет запись в LDAP-каталог

Описание

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

Функция добавляет запись в LDAP-директорию.

Список параметров

ldap

Экземпляр класса LDAP\Connection, который возвращает функция ldap_connect().

dn

Отличительное имя LDAP-объекта.

entry

Массив, который определяет информацию о записи. Значения в записи индексируются индивидуальными атрибутами. В случае множественных значений для атрибута, они индексируются с использованием целых чисел, начиная с 0.

<?php

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

?>

controls

Массив управляющих объектов протокола LDAP для отправки в запросе.

Возвращаемые значения

Функция возвращает true, если выполнилась успешно, или false, если возникла ошибка.

Список изменений

Версия	Описание
8.1.0	Параметр `ldap` теперь ожидает экземпляр класса LDAP\Connection; раньше параметр ждал ресурс (resource) `ldap link` .
8.0.0	Параметр `controls` теперь допускает значение null; раньше значение по умолчанию равнялось `[]`.
7.3.0	Добавлена поддержка параметра `controls`

Примеры

Пример #1 Полный пример с проверкой подлинности привязки

<?php

$ds = ldap_connect("localhost");  // Предположим, что сервер LDAP находится тут

if ($ds) {
    // Привязка к соответствующему dn для возможности обновления
    $r = ldap_bind($ds, "cn=root, o=My Company, c=US", "secret");

    // Подготовить данные
    $info["cn"] = "John Jones";
    $info["sn"] = "Jones";
    $info["objectclass"] = "person";

    // Добавить данные
    $r = ldap_add($ds, "cn=John Jones, o=My Company, c=US", $info);

    ldap_close($ds);
} else {
    echo "Невозможно соединиться с сервером LDAP";
}

?>

Примечания

Замечание: Функция безопасна для обработки данных в двоичной форме.

Смотрите также

ldap_add_ext() - Добавить записи в каталог LDAP
ldap_delete() - Удаляет запись из каталога LDAP