(PHP 4, PHP 5, PHP 7, PHP 8)
ldap_get_attributes — 検索結果エントリから属性を得る
検索結果エントリから属性と値を読み込みます。
ディレクトリに特定のエントリを置いている場合、この関数をコールする ことにより、そのエントリに関して保持されている情報得ることができます。 ディレクトリエントリを "ブラウズ" するか、ディレクトリエントリの 構造が未知であるアプリケーションにおいてこの関数を使用します。 多くのアプリケーションにおいては、電子メールアドレスや姓のような 特定の属性を検索するため、保持されている他のデータにどんなものがあるか ということは問題にならないと思われます。
return_value["count"] = そのエントリの属性の数 return_value[0] = 最初の属性 return_value[n] = n 番目の属性 return_value["attribute"]["count"] = その属性に関する値の数 return_value["attribute"][0] = その属性に関する最初の値 return_value["attribute"][i] = その属性に関する (i+1) 番目の値
成功時に完全なエントリ情報を多次元配列で返します。エラーの場合、
false を返します。
| バージョン | 説明 |
|---|---|
| 8.1.0 |
引数 ldap は、LDAP\Connection
クラスのインスタンスを期待するようになりました。
これより前のバージョンでは、リソース を期待していました。
|
| 8.1.0 |
引数 entry は、
LDAP\ResultEntry
クラスのインスタンスを期待するようになりました。
これより前のバージョンでは、リソース を期待していました。
|
例1 特定のディレクトリエントリに関して保持されている属性のリストを表示
<?php
// $ds はディレクトリのリンク ID
// $sr は事前の LDAP のディレクトリ検索コールの有効な結果
$entry = ldap_first_entry($ds, $sr);
$attrs = ldap_get_attributes($ds, $entry);
echo $attrs["count"] . " attributes held for this entry:<p>";
for ($i=0; $i < $attrs["count"]; $i++) {
echo $attrs[$i] . "<br />";
}
?>