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

# ldap_add

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

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

### Описание

function 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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open