ldap_bind

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

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

Описание

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