ldap_modify_batch
(PHP 5.4 >= 5.4.26, PHP 5.5 >= 5.5.10, PHP 5.6 >= 5.6.0, PHP 7, PHP 8)
ldap_modify_batch — Формування та запуск пакетної зміни запису LDAP
Опис
ldap_modify_batch( LDAP\Connection $ldap, string $dn, array $modifications_info, ?array $controls = null): bool
Модифікує існуючий запис у каталозі LDAP. Допустимо детальний опис модифікації.
Список параметрів
ldap
Екземпляр LDAP\Connection, що повертається функцією ldap_connect()
dn
Характерне ім'я об'єкта LDAP.
modifications_info
Масив, який описує необхідну модифікацію. Кожен запис цього масиву є асоціативним масивом з двома або трьома ключами: attrib задає ім'я атрибута для зміни, modtype задає тип модифікації та (залежно від типу модифікації) values задає масив значень атрибутів, що відповідає даній модифікації.
Допустимі значення для modtype :
LDAP_MODIFY_BATCH_ADD
Каждое значение заданное вvaluesбудет добавлено (как дополнительное значение) к атрибутуattrib
LDAP_MODIFY_BATCH_REMOVE
Каждое значение заданное вvaluesбудет удалено из атрибута заданного вattribНи одно значение не указанное вvaluesне будет затронуто.
LDAP_MODIFY_BATCH_REMOVE_ALL
Усі значення будуть видалені у атрибуту attribПараметрvaluesне нужен.
LDAP_MODIFY_BATCH_REPLACE
Все существующие значения атрибутаattrib будуть замінені значеннями зазначеними в values
Обратите внимание, что все значенияattrib повинні бути рядками, всі значення values повинні бути масивами рядків та будь-які значення modtype повинні бути однією з констант LDAP_MODIFY_BATCH_*, Перерахованих вище.
controls
Массивкеруючих констант LDAPдля отправки в запросе.
Значення, що повертаються
Повертає true у разі успішного виконання або **false**в случае возникновения ошибки.
список змін
| Версия | Опис |
|---|---|
| 8.1.0 | Параметрldap тепер чекає екземпляр LDAP\Connection; раніше очікувався ресурс (resourceldap link |
| 8.0.0 | controls тепер припускає значення null; раніше значення за умовчанням було [] |
| 7.3.0 | Додано підтримку параметра controls |
Приклади
Приклад #1 Додавання контакту номера
Приклад #2 Перейменування користувача
Приклад #3 Додавання користувачу двох e-mail адрес
Приклад #4 Зміна пароля користувача
Приклад #5 Зміна пароля користувача (Active Directory)