(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 некорректен");
?>