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

    ?>

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

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