PHP マニュアル: 検索結果エントリから属性を得る

説明

array ldap_get_attributes(LDAP\Connection $ldap, LDAP\ResultEntry $entry)

検索結果エントリから属性と値を読み込みます。

ディレクトリに特定のエントリを置いている場合、この関数をコールすることにより、そのエントリに関して保持されている情報得ることができます。ディレクトリエントリを "ブラウズ" するか、ディレクトリエントリの構造が未知であるアプリケーションにおいてこの関数を使用します。多くのアプリケーションにおいては、電子メールアドレスや姓のような特定の属性を検索するため、保持されている他のデータにどんなものがあるかということは問題にならないと思われます。

return_value["count"] = そのエントリの属性の数
return_value[0] = 最初の属性
return_value[n] = n 番目の属性

return_value["attribute"]["count"] = その属性に関する値の数
return_value["attribute"][0] = その属性に関する最初の値
return_value["attribute"][i] = その属性に関する (i+1) 番目の値

パラメータ

ldap: ldap_connect が返す LDAP\Connection クラスのインスタンス。
entry: LDAP\ResultEntry クラスのインスタンス。

戻り値

完全なエントリ情報を多次元配列で返します。

変更履歴

バージョン	説明
8.1.0	引数 `ldap` は、LDAP\Connection クラスのインスタンスを期待するようになりました。これより前のバージョンでは、有効な `ldap link` resource を期待していました。
8.1.0	引数 `entry` は、 LDAP\ResultEntry クラスのインスタンスを期待するようになりました。これより前のバージョンでは、有効な `ldap result entry` resource を期待していました。

例

例1 特定のディレクトリエントリに関して保持されている属性のリストを表示

<?php
// $ds はディレクトリサーバーへの LDAP\Connection のインスタンス

// $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 />";
}
?>

参考

ldap_first_attribute
ldap_next_attribute