MongoCollection
PHP Manual

MongoCollection::findOne

(PECL mongo >=0.9.0)

MongoCollection::findOneコレクションに問い合わせ、単一の要素を返す

説明

public array MongoCollection::findOne ([ array $query = array() [, array $fields = array() ]] )

パラメータ

query

検索したいフィールド。

fields

結果を返したいフィールド。

返り値

検索にマッチしたレコード、あるいは 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 フィールドしか含まれないことに注目しましょう。


MongoCollection
PHP Manual