(PECL mongo >=0.9.0)
MongoCollection::findOne — コレクションに問い合わせ、単一の要素を返す
検索したいフィールド。
結果を返したいフィールド。
検索にマッチしたレコード、あるいは NULL を返します。
データベースに接続できない場合に MongoConnectionException をスローします。
例1 MongoCollection::findOne() での id による検索
この例は、コレクション内のドキュメントを id から検索する方法を示します。
<?php
$articles = $mongo->my_db->articles;
$article = $articles->findOne(array('_id' => new MongoId('47cc67093475061e3d9536d2')));
?>
例2 MongoCollection::findOne() での複数条件の使用
この例は、コレクション内のドキュメントを複数の条件で検索し、返されるフィールドを絞り込む方法を示します。
<?php
$users = $mongo->my_db->users;
$user = $users->findOne(array('username' => 'jwage'), array('password'));
print_r($user);
?>
上の例の出力は、 たとえば以下のようになります。
Array
(
[_id] => MongoId Object
(
)
[password] => test
)
たとえドキュメントに username フィールドがあっても、 返される結果には password フィールドしか含まれないことに注目しましょう。