(PHP 4 >= 4.0.2, PHP 5, PHP 7, PHP 8)
ldap_compare — Сравнить значение атрибута, найденного в записи определённой DN
$ldap
,$dn
,$attribute
,$value
,$controls
= null
Сравнивает значение (value
) атрибута (attribute
)
со значением того же атрибута в записи LDAP-директории.
ldap
Экземпляр LDAP\Connection, возвращаемый функцией ldap_connect().
dn
Отличительное имя LDAP-объекта.
attribute
Имя атрибута.
value
Сравниваемое значение.
controls
Массив управляющих констант LDAP для отправки в запросе.
Возвращает true
если value
совпадают в противном случае false
.
Возвращает -1 в случае возникновения ошибки.
Версия | Описание |
---|---|
8.1.0 |
Параметр ldap теперь ожидает экземпляр LDAP\Connection;
ранее ожидался ресурс (resource) ldap link .
|
8.0.0 |
controls теперь допускает значение null; ранее значение по умолчанию было [] .
|
7.3.0 |
Добавлена поддержка параметра controls
|
Следующий пример демонстрирует, как проверить, совпадает ли данный пароль с тем, который определён в указанной записи DN.
Пример #1 Полный пример проверки пароля
<?php
$ds=ldap_connect("localhost"); // Предположим, что LDAP сервер находится по этому адресу
if ($ds) {
// bind
if (ldap_bind($ds)) {
// подготовка данных
$dn = "cn=Matti Meikku, ou=My Unit, o=My Company, c=FI";
$value = "secretpassword";
$attr = "password";
// сравнение данных
$r=ldap_compare($ds, $dn, $attr, $value);
if ($r === -1) {
echo "Ошибка: " . ldap_error($ds);
} elseif ($r === true) {
echo "Пароль верный.";
} elseif ($r === false) {
echo "Неправильное предположение! Пароль не верен.";
}
} else {
echo "Невозможно привязаться к серверу LDAP.";
}
ldap_close($ds);
} else {
echo "Невозможно соединиться с сервером LDAP.";
}
?>
ldap_compare() не может быть использована для сравнения бинарных (BINARY) значений!