ldap_connect

(PHP 4, PHP 5, PHP 7, PHP 8)

ldap_connectПодключиться к серверу LDAP

Описание

ldap_connect(?string $uri = null): LDAP\Connection|false
Внимание

Следующий синтаксис всё ещё поддерживается для обеспечения обратной совместимости (кроме использования именованных аргументов), но он объявлен устаревшим и больше не должен использоваться!

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

?>

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

  • ldap_bind() - Привязать к LDAP директории