MongoCursor
PHP Manual

MongoCursor::addOption

(PECL mongo >=1.0.4)

MongoCursor::addOptionトップレベルの キー/値 のペアをクエリに追加する

説明

public MongoCursor MongoCursor::addOption ( string $key , mixed $value )

これは高度な関数なので、今何をしているのかをわかっている人以外は使ってはいけません。

ソートやヒントなどの他のオプションを指定する場合は、クエリを "query" フィールドに書くこともできます。 たとえばソートを追加した場合は、 クエリは次のようにサブフィールドのひとつとなります。

<?php

$query 
= array("query" => $query"orderby" => $sort);

?>

このメソッドは、トップレベルのフィールドをクエリに追加します。 クエリにサブオブジェクトを作成 (まだ存在しない場合) し、 指定した キー/値 のペアをトップレベルに追加します。

警告

クエリにその場で条件を追加するという目的で使うことはできません。たとえば、 これは正しく動作しません

<?php

// 間違った使いかた
$cursor $users->find()->addOption("name""joe")->addOption("age"20);

?>
これは、名前が "joe" で 20 才のユーザを捜すというクエリには なりません

パラメータ

key

追加したいフィールド名。

value

追加したい値。

返り値

このカーソルを返します。

エラー / 例外

カーソルの反復処理が始まっている場合は MongoCursorException をスローします。

例1 MongoCursor::addOption() の例

MongoCursor::skip() を使って何百万件もの結果をスキップすると、 処理速度が低下します。これを回避する方法のひとつが、クエリのオプション $min あるいは $max を使うことです。 これらは便利ですが、検索するフィールドにインデックスがなければなりません。 この例は、$minMongoCursor::skip() の代替として使う方法を示します。

<?php

// インデックスがなければなりません
$c->ensureIndex(array("ts" => 1));

// マシンの性能によって、この値を適宜変更しなければならないかもしれません
// (性能の良いマシンで 30 秒ほどかかります)
for ($i 0$i 30000000$i++) {
    
$c->insert(array("ts" => new MongoDate(), "i" => $i));
}

$now strtotime("now");

// 最後の 2 秒で追加されたドキュメントを探します
$cursor $c->find()->addOption('$min', array("ts" => $now-2));

?>

MongoCursor
PHP Manual