ldap_connect
(PHP 4, PHP 5, PHP 7, PHP 8)
ldap_connect — Підключається до сервера LDAP
Опис
ldap_connect(?string $uri = null): LDAP\Connection|false
Увага
Починаючи з PHP 8.3.0 наступнасигнатура устарела:
ldap_connect(?string $host = null, int $port = 389): LDAP\Connection|false
Створює об'єкт LDAP\Connection та перевіряє правдоподібність заданого у параметрі uriзначения.
Зауваження: Ця функція не відкриває з'єднання. Вона перевіряє, чи правдоподібні задані параметри і чи можна, вказавши їх, встановити з'єднання, коли воно необхідне.
Список параметрів
host
Повний LDAP URI виду ldap://hostname:portилиldaps://hostname:port
Можна також вказати кілька LDAP-URI, розділених пробілом.
Обратите внимание, чтоhostname:port — це LDAP URI, що не підтримується, оскільки відсутня схема.
uri
Ім'я сервера для з'єднання.
port
Порт для підключення.
Значення, що повертаються
Повертає екземпляр LDAP\Connection, якщо LDAP URI є правдоподібним. Вона здійснює синтаксичний аналіз та перевірку переданих параметрів, але з'єднання з сервером не відбувається. Якщо перевірка синтаксису провалилася - повертається falseФункцияldap_connect() завжди повертатиме екземпляр LDAP\Connectionоскільки вона фактично не з'єднується, а лише ініціалізує параметри з'єднання. Фактичне підключення відбувається за наступних викликів функцій ldap_*зазвичай при виклику функції ldap_bind()
Якщо жодних параметрів не буде визначено, тоді буде повернуто екземпляр відкритого з'єднання.LDAP\Connection
список змін
| Версия | Опис |
|---|---|
| 8.3.0 | Тепер виклик функції ldap_connect() з окремою вказівкою імені хоста hostname та порту portустарел. |
| 8.1.0 | Повертає екземпляр LDAP\Connection; раніше повертався ресурс (resource |
Приклади
Приклад #1 Приклад підключення до LDAP-сервера.
Приклад #2 Приклад безпечного підключення до LDAP-сервера.
Дивіться також
- ldap_bind() - Прив'язати до LDAP директорії