ldap_connect
(PHP 4, PHP 5, PHP 7)
ldap_connect — Подключиться к серверу LDAP
Описание
$uri = null
) : resource|falseСледующий синтаксис все еще поддерживается для обеспечения обратной совместимости (кроме использования именованных аргументов), но он объявлен устаревшим и больше не должен использоваться!
$host = null
, int $port = 389
) : resource|false
Создает идентификатор соединения LDAP и проверяет правдоподобность
заданного uri.
Замечание: Эта функция НЕ открывает соединение. Она проверяет, правдоподобны ли заданные параметры и могут ли они использоваться для подключения, когда в нем возникнет нужна.
Список параметров
-
uri -
Полный LDAP URI вида
ldap://hostname:portилиldaps://hostname:port.Также вы можете указать несколько LDAP-URI, разделенных пробелом.
Обратите внимание, что
hostname:port- это неподдерживаемый LDAP URI, так как отсутствует схема. -
host -
Имя сервера для соединения.
-
port -
Порт для соединения.
Возвращаемые значения
Возвращает положительный идентификатор ссылки LDAP, если LDAP URI правдоподобен.
Она производит синтаксический разбор и
проверку переданных параметров, но соединения с сервером не происходит. Если проверка
синтаксиса провалилась - возвращается false.
ldap_connect() будет всегда возвращать resource,
поскольку она фактически не соединяется, а только инициализирует параметры соединения.
Фактическое подключение происходит при последующих вызовах ldap_* функций, обычно
при вызове ldap_bind().
Если никакие параметры не будут определены, тогда будет возвращен идентификатор уже открытой ссылки.
Примеры
Пример #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 некорректен");
?>