(PHP 4, PHP 5, PHP 7, PHP 8)
ldap_connect — Подключается к серверу LDAP
Начиная с PHP 8.3.0 следующая сигнатура устарела:
Создаёт объект 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.
<?php
// LDAP переменные
$ldapuri = "ldap://ldap.example.com:389"; // ldap-uri
// Соединение с LDAP
$ldapconn = ldap_connect($ldapuri)
or die("LDAP-URI некорректен");
?>Пример #2 Пример безопасного подключения к серверу LDAP.
<?php
// Убедитесь, что ваш хост корректный и
// что вы выдали ему сертификат безопасности
$ldaphost = "ldaps://ldap.example.com/";
// Соединение с LDAP
$ldapconn = ldap_connect($ldaphost)
or die("LDAP-URI некорректен");
?>