(PHP 4, PHP 5, PHP 7, PHP 8)
ldap_connect — Подключиться к серверу LDAP
Следующий синтаксис всё ещё поддерживается для обеспечения обратной совместимости (кроме использования именованных аргументов), но он объявлен устаревшим и больше не должен использоваться!
Создаёт 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.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 некорректен");
?>