Retrieve Data

Datos de muestra

Los ejemplos de esta guía utilizan la colección companies en la base de datos sample_training de los conjuntos de datos de muestra de Atlas. Para acceder a esta colección desde tu aplicación PHP, instancia un MongoDB\Client que se conecte a un clúster Atlas y asigna el siguiente valor a tu variable $collection:

$collection = $client->sample_training->companies;

Para saber cómo crear una implementación gratuita de MongoDB y cargar los conjuntos de datos de ejemplo, consulta la guía MongoDB Primeros Pasos.

Encuentre un documento

Para encontrar un solo documento en una colección, llama al método MongoDB\Collection::findOne() y pasa un filtro de query que especifique los criterios del documento que desea encontrar.

El método findOne() devuelve un valor array, object o null. Si el filtro de query coincide con un documento, el método devuelve una instancia array|object que contiene el documento. El tipo de retorno depende del valor de la opción typeMap. Si el filtro de query no coincide con ningún documento, el método devuelve null.

Si el filtro de query coincide con más de un documento, el método findOne() retorna el primer documento coincidente entre los resultados recuperados.

El siguiente ejemplo utiliza el método findOne() para encontrar el primer documento en el que el campo name tiene el valor 'LinkedIn':

$document = $collection->findOne(['name' => 'LinkedIn']);
echo json_encode($document), PHP_EOL;

{"_id":{"$oid":"..."},"name":"LinkedIn","permalink":"linkedin","crunchbase_url":
"http:\/\/www.crunchbase.com\/company\/linkedin","homepage_url":"http:\/\/linkedin.com",
... }

Encuentra varios documentos

Para encontrar varios documentos en una colección, pasar un filtro de query al método MongoDB\Collection::find() que especifique los criterios de los documentos que desea recuperar.

El siguiente ejemplo utiliza el método find() para encontrar todos los documentos en los que el campo founded_year tiene el valor 1970:

$results = $collection->find(['founded_year' => 1970]);

El método find() devuelve una instancia de MongoDB\Driver\Cursor, la cual puedes iterar para ver los documentos coincidentes. Un cursor es un mecanismo que permite a una aplicación iterar sobre los resultados de una base de datos mientras mantiene en memoria solo un subconjunto de ellos en un momento dado. Los cursores son útiles cuando tu método find() devuelve una gran cantidad de documentos.

Puedes iterar sobre los documentos en un cursor utilizando un bucle foreach, como se muestra en el siguiente ejemplo:

foreach ($results as $doc) {
    echo json_encode($doc), PHP_EOL;
}

{"_id":{"$oid":"..."},"name":"Mitsubishi Motors","permalink":"mitsubishi-motors",
"crunchbase_url":"http:\/\/www.crunchbase.com\/company\/mitsubishi-motors",
... }
{"_id":{"$oid":"..."},"name":"Western Digital","permalink":"western-digital",
"crunchbase_url":"http:\/\/www.crunchbase.com\/company\/western-digital",
... }
{"_id":{"$oid":"..."},"name":"Celarayn","permalink":"celarayn","crunchbase_url":
"http:\/\/www.crunchbase.com\/company\/celarayn",
... }

$cursor = $collection->find([]);

Modificar el comportamiento de búsqueda

Puedes modificar el comportamiento de los métodos MongoDB\Collection::find() y MongoDB\Collection::findOne() pasando un arreglo que especifique los valores de opciones como parámetro. La siguiente tabla describe algunas opciones que puedes configurar en el arreglo:

El siguiente ejemplo usa el método find() para encontrar todos los documentos en los que el campo number_of_employees tiene el valor 1000. El ejemplo utiliza la opción limit para devolver un máximo de 5 resultados:

$results = $collection->find(
    ['number_of_employees' => 1000],
    ['limit' => 5],
);
foreach ($results as $doc) {
    echo json_encode($doc), PHP_EOL;
}

Para obtener una lista completa de opciones, consulte la documentación de la API de los parámetros findOne() y find().

Documentación de la API

Para obtener más información sobre cualquiera de los métodos mencionados en esta guía, consulta la siguiente documentación de la API:

• MongoDB\Collection::findOne()
• MongoDB\Collection::find()