Retrieve Data

Datos de muestra

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

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

Para aprender cómo crear una implementación gratuita de MongoDB y cargar los conjuntos de datos de muestra, consulte la guía de introducción a MongoDB.

Encuentre un documento

Para encontrar un solo documento en una colección, llame al método MongoDB\Collection::findOne() y pase un filtro de consulta 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 consulta coincide con más de un documento, el findOne() método devuelve el primer documento coincidente de 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, que se puede iterar para ver los documentos coincidentes. Un cursor es un mecanismo que permite a una aplicación iterar sobre los resultados de la base de datos, manteniendo solo un subconjunto de ellos en memoria en un momento dado. Los cursores son útiles cuando el método find() devuelve una gran cantidad de documentos.

Puede 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

Puede modificar el comportamiento de los métodos MongoDB\Collection::find() y MongoDB\Collection::findOne() pasando una matriz que especifique valores de opción como parámetro. La siguiente tabla describe algunas opciones que puede configurar en la matriz:

El siguiente ejemplo utiliza el método find() para buscar todos los documentos cuyo campo number_of_employees tenga 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 para los parámetros findOne() y find().

Documentación de la API

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

• MongoDB\Collection::findOne()

• MongoDB\Collection::find()