検索

DN についてのちょっとしたメモ

特殊文字 (",", "+", """, "\", "<", ">", ";", "#", "=", space or a hexpair) を DN の属性や値に使用することもできます。 Net_LDAP2_Util::escape_dn_value()、 Net_LDAP2_Util::unescape_dn_value()、 Net_LDAP2_Util::ldap_explode_dn() そして Net_LDAP2_Util::canonical_dn() の API ドキュメントを参照ください。 これらの関数を用いると、DN を安全に処理することができます。

エントリの検索

サーバに接続したら、Net_LDAP の search() メソッドでディレクトリを検索しましょう。 このメソッドのパラメータは次の三つです。

• $base は検索時に使用するベース DN です。 null のままにしておくと、 接続時に指定したデフォルトのベース DN を使用します。

• $filter は、返される結果を指定するための問い合わせフィルタです。 文字列 (熟練者用) か、あるいは Net_LDAP_Filter オブジェクトで指定します。オブジェクトで指定することをお勧めします。 Net_LDAP_Filter は、LDAP のフィルタに適したエスケープを自動的に行います。 LDAP フィルタについては、別途 LDAP フィルタ で説明します。

• $params は、現在のクエリで使用する設定項目の配列となります。

  表 54-1設定パラメータ

  名前	説明	デフォルト
  scope	検索で使用するスコープ base - 単一のエントリのみ sub - そのツリー全体 one - $base の直下のみ	sub
  sizelimit	結果として返すエントリの最大数	0 (無制限)
  timelimit	検索時の最大の待ち時間	0 (無制限)
  attrsonly	true の場合は属性名のみを返す	false
  attributes	そのエントリが含んでいる属性名の配列。 必要な属性のみに絞り込むことをお勧めします。	array() (すべての属性)

// 非常に簡単なフィルタを作成します。
// ここでは、姓が "Joe" ではじまるエントリをすべて取得します
$filter = Net_LDAP_Filter::create('sn', 'begins',  'Joe');

// 独自の検索ベースを指定します。NULL を渡すと、Net_LDAP の設定で
// 指定した値を使用します。これはおそらくご希望のものとは異なるでしょう。
$searchbase = 'ou=addressbook,dc=example,dc=org';

// その他のオプション。
// 'ou=addressbook,dc=example,dc=org' 配下のすべてのツリーを検索し、
// 属性 'sn' のみを取得します。あとで実際に使用する属性のみを
// 取得するようにしておくことをお勧めします。
// しかし、不要な属性も含めて取得するほうが、
// 属性を取得するためだけに配列を再度読み込むよりも高速です。
$options = array(
    'scope' => 'sub',
    'attributes' => array('sn')
);

// さぁ、検索です!
$search = $ldap->search($searchbase, $filter, $options);

// エラーが出ていないかどうかを確かめます。
if (PEAR::isError($search)) {
    die($search->getMessage() . "\n");
}

// 何件見つかったのかを表示します。
echo "全部で " . $search->count() . " 件のエントリが見つかりました!";