[edit] Last updated: Fri, 25 May 2012

MongoCollection::findOne

(PECL mongo >=0.9.0)

MongoCollection::findOne — Interroge cette collection, retourne un seul élément

Description

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

Contrairement à la méthode MongoCollection::find(), cette méthode retournera seulement le premier résultat du jeu de données, et non un MongoCursor sur lequel on aurait pu boucler.

Liste de paramètres

query: Le champ dans lequel la recherche va s'effectuer. Le langage de requête MongoDB est relativement extensible. Le driver PHP passera dans la plupart des cas la requête au serveur, aussi, nous vous invitons à lire la documentation du coeur de MongoDB sur » find pour mieux comprendre le fonctionnement.

Avertissement
Assurez-vous que pour tous les opérateurs spéciaux de la requête (ceux commençant par $) vous utilisez des guillemets doubles, ainsi, PHP ne tentera pas de remplacer "$exists" avec la valeur de la variable $exists.
fields: Les champs de résultat à retourner. Le tableau est au format array('fieldname' => true, 'fieldname2' => true). Le champ _id sera, quant à lui, toujours retourné.

Valeurs de retour

Retourne les enregistrements qui correspondent aux critères, ou bien NULL.

Erreurs / Exceptions

Lance une exception MongoConnectionException si l'on ne peut joindre la base de données.

Exemples

Exemple #1 MongoCollection::findOne() Cherche un document par son id.

Cet exemple montre comment récupérer un document dans une collection par son id.


<?php

$articles = $mongo->my_db->articles;

$article = $articles->findOne(array('_id' => new MongoId('47cc67093475061e3d9536d2')));

?>

Exemple #2 MongoCollection::findOne() Cherche un document par condition.

Cet exemple montre comment récupérer un document dans une collection au moyen d'un condition en limitant les champs retournés.


<?php

$users = $mongo->my_db->users;
$user = $users->findOne(array('username' => 'jwage'), array('password'));
print_r($user);

?>

L'exemple ci-dessus va afficher quelque chose de similaire à :

Array
(
    [_id] => MongoId Object
        (
        )

    [password] => test
)

Remarquez que même si le document possède un champ username, nous limitons les résultats au seul champ password.

Voir aussi

MongoCollection::find() - Interroge une collection, et retourne comme jeu de résultats un objet MongoCursor
MongoCollection::insert() - Insère un tableau dans la collection
Documentation coeur de MongoDB sur » find.

MongoCollection::__get

MongoCollection::find

[edit] Last updated: Fri, 25 May 2012

add a note User Contributed Notes MongoCollection::findOne

fred dot trotter at gmail dot com 14-Apr-2012 02:35


For whatever reason the @ symbol throws the php implementation of findOne for a loop.



I think this is the same problem that ejs5 was experiencing but if you are trying to do a findOne on an email address like



$an_array = $col->findOne('email' => 'fred.trotter@example.com');



You will get nothing.

But if you do:



$an_cursor = $col->find('email' => 'fred.trotter@example.com');

$an_array = $an_cursor->getNext();



you will have the same result. 

Interestingly I was not able to replicate this problem with the '&' symbol that ejs5 complained about. Perhaps this is a bug being chased down across versions. Hope this helps someone.



-FT

ejs5 at g2link dot com 10-Dec-2010 05:30


Special characters seem to be automatically escaped by the Mongo driver. 



<?php



$db = $mongo->my_db->wireless_service_providers;

$provider = $db->findOne(array("name" => "AT&T"), array('_id' => 1));

print_r($provider);



?>



if the value is stored as "AT&T" in the document you will get



Array([_id]=>)



but if the value is stored as "AT&AMP;T" it will return



Array ( [_id] => MongoId Object ( ) )

dominik at dokdok dot com 30-Sep-2010 08:44


There is also a notation to retrieve all fields, but the specified ones



<?php



$users = $mongo->my_db->users;

$user = $users->findOne(array('username' => 'jwage'), array('password' => 0));

print_r($user);



?>



Will return all fields of the user, but the password field.

add a note