(PHP 4 >= 4.0.2, PHP 5, PHP 7, PHP 8)
ldap_compare — 指定した DN のエントリで見付かった属性の値を比較する
$ldap,$dn,$attribute,$value,$controls = null
属性 attribute の値 value
を、指定した LDAP ディレクトリエントリの同じ属性の値と比較します。
ldapldap_connect() が返す LDAP\Connection クラスのインスタンス。
dnLDAP エンティティの識別名。
attribute属性の名前。
value比較する値。
controlsリクエストと一緒に送信する LDAP コントロール の配列
value がマッチする場合に true、その他の場合に
false、エラーの場合に -1 を返します。
| バージョン | 説明 |
|---|---|
| 8.1.0 |
引数 ldap は、LDAP\Connection
クラスのインスタンスを期待するようになりました。
これより前のバージョンでは、リソース を期待していました。
|
| 8.0.0 |
controls は、nullable になりました。
これより前のバージョンでは、デフォルト値が [] でした。
|
| 7.3 |
controls のサポートが追加されました。
|
次の例は、指定したパスワードが DN の指定したエントリで定義された ものと一致するかどうかをチェックする方法を示しています。
例1 パスワード確認の例
<?php
$ds=ldap_connect("localhost"); // LDAP サーバーが同一ホストであると仮定
if ($ds) {
// バインド
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 "Error: " . ldap_error($ds);
} elseif ($r === true) {
echo "Password correct.";
} elseif ($r === false) {
echo "Wrong guess! Password incorrect.";
}
} else {
echo "Unable to bind to LDAP server.";
}
ldap_close($ds);
} else {
echo "Unable to connect to LDAP server.";
}
?>
ldap_compare() では BINARY 値を比較することはできません!