ldap_add
(PHP 4, PHP 5, PHP 7)
ldap_add — Добавить запись в LDAP директорию
Описание
$ldap
, string $dn
, array $entry
, array|null $controls = null
) : boolДобавляет запись в LDAP-директорию.
Список параметров
-
ldap -
Идентификатор ссылки LDAP, возвращенный ldap_connect().
-
dn -
Отличительное имя LDAP-объекта.
-
entry -
Массив, который определяет информацию о записи. Значения в записи индексируются индивидуальными атрибутами. В случае множественных значений для атрибута, они индексируются с использованием целых чисел, начиная с 0.
<?php
$entry["attribute1"] = "value";
$entry["attribute2"][0] = "value1";
$entry["attribute2"][1] = "value2";
?> -
controls -
Массив управляющих констант LDAP для отправки в запросе.
Возвращаемые значения
Возвращает true в случае успешного завершения или false в случае возникновения ошибки.
Список изменений
| Версия | Описание |
|---|---|
| 8.0.0 |
controls теперь допускает значение null; ранее значение по умолчанию было [].
|
| 7.3 |
Добавлена поддержка параметра 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