Localizando documentos usando MongoCollection::findOne()
Para comprobar que el documento que insertamos en el paso anterior está almacenado en la base de datos, podemos realizar una operación MongoCollection::findOne() para obtener un único documento de la colección. Este método es útil cuando sólo hay un documento que concuerde con la consulta, o cuando sólo se está interesado en un resultado.
<?php
$conexión = new MongoClient();
$colección = $conexión->database->collectionName;
$documento = $colección->findOne();
var_dump( $documento );
?>
El resultado del ejemplo sería:
array(6) {
["_id"]=>
object(MongoId)#8 (1) {
["$id"]=>
string(24) "4e2995576803fab768000000"
}
["name"]=>
string(7) "MongoDB"
["type"]=>
string(8) "database"
["count"]=>
int(1)
["info"]=>
array(2) {
["x"]=>
int(203)
["y"]=>
int(102)
}
["versions"]=>
array(3) {
[0]=>
string(5) "0.9.7"
[1]=>
string(5) "0.9.8"
[2]=>
string(5) "0.9.9"
}
}
Hay un campo _id que se ha añadido automáticamente al documento. _id es el campo de la "clave primaria". Si el documento no especifica una, el controlador la añadirá automáticamente.
Si se ha especificado un campo _id, debe ser único en toda la colección. Por ejemplo:
<?php
$conexión = new MongoClient();
$bd = $conexión->database;
$bd->foo->insert(array("_id" => 1));
// esto lanzará una excepción
$bd->foo->insert(array("_id" => 1));
// esto está bien, ya que es una colección diferente
$bd->bar->insert(array("_id" => 1));
?>
Por omisión, el controlador se asegurará de que el servidor ha aceptado la escritura antes de devolver. Opcionalmente se puede desactivar este comportamiento pasando array("w" => 0) como segundo argumento. Esto significa que el controlador debería no esperar a que la base de datos acepte la escritura y no lanzar la excepción de _id duplicado.
Ver También
MongoCollection::findOne() contiene más información sobre cómo localizar datos.
MongoId ofrece más detalles de los identificadores únicos.
La sección writes trata las escrituras en mayor profundidad, y el capítulo Asuntos de Escritura (Write Concerns) entra en detalles sobre las diferentes opciones de Write Concern.
add a note
