array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.ldap-connect.php', 1 => 'ldap_connect', 2 => 'Подключается к серверу LDAP', ), 'up' => array ( 0 => 'ref.ldap.php', 1 => 'Функции LDAP', ), 'prev' => array ( 0 => 'function.ldap-compare.php', 1 => 'ldap_compare', ), 'next' => array ( 0 => 'function.ldap-connect-wallet.php', 1 => 'ldap_connect_wallet', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/ldap/functions/ldap-connect.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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.

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

?>

Смотрите также