ldap_bind

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

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

Описание

function ldap_bind(LDAP\Connection $ldap, ?string $dn = null, #[\SensitiveParameter]?string $password = null): bool

Функция связывает LDAP-каталог с указанным RDN-именем и паролем.

Список параметров

ldap

Экземпляр класса LDAP\Connection, который возвращает функция ldap_connect().

dn

password

Если параметр password не определили или пустой, функция попытается привязать имя и пароль анонимно. Для анонимной привязки также можно оставить пустым параметр dn, как определяет раздел Authentication and Other Security Services стандарта RFC 2251: https://tools.ietf.org/html/rfc2251#section-4.2.2

Возвращаемые значения

Функция возвращает true, если выполнилась успешно, или false, если возникла ошибка.

Список изменений

Версия Описание
8.1.0 Параметр ldap теперь принимает объект LDAP\Connection; раньше параметр ждал ресурс (resource) ldap link .

Примеры

Пример #1 Пример привязки к LDAP-каталогу

<?php

// Связываем LDAP-каталог
$ldaprdn  = 'uname';     //  RDN- или DN-имя LDAP-сервера
$ldappass = 'password';  // Ассоциированный пароль

// Соединяемся с сервером
$ldapconn = ldap_connect("ldap://ldap.example.com")
    or die("Не могу соединиться с LDAP-сервером.");

if ($ldapconn) {
    // Привязываемся к LDAP-серверу
    $ldapbind = ldap_bind($ldapconn, $ldaprdn, $ldappass);

    // Проверяем привязку
    if ($ldapbind) {
        echo "LDAP-привязка прошла успешна...";
    } else {
        echo "LDAP-привязка не удалась...";
    }
}

?>

Пример #2 Использование анонимной привязки LDAP

<?php

// Анонимная LDAP-привязка

// Соединяемся с LDAP-сервером
$ldapconn = ldap_connect("ldap://ldap.example.com")
    or die("Не могу соединиться с LDAP-сервером.");

if ($ldapconn) {
    // Привязываемся анонимно
    $ldapbind = ldap_bind($ldapconn);

    if ($ldapbind) {
        echo "Анонимная привязка LDAP прошла успешно...";
    } else {
        echo "Анонимная привязка LDAP не удалась...";
    }
}

?>

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

  • ldap_bind_ext() - Привязывает к LDAP-каталогу
  • ldap_unbind() - Разорвать привязку к директории LDAP