Подключается к серверу LDAP

# ldap_connect

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

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

### Описание

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

Начиная с PHP 8.3.0 следующая сигнатура устарела:

function 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.4.0 | Теперь вызов функции ldap_connect() с более чем двумя аргументами устарел.
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 некорректен");

    ?>

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

- ldap_bind() - Привязывает к LDAP-каталогу

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open