Retrieve Data

Overview

En esta guía, aprenderá a recuperar datos de colecciones de MongoDB mediante Laravel MongoDB. Describe los métodos del modelo Eloquent que puede usar para recuperar datos y proporciona ejemplos de diferentes tipos de operaciones de búsqueda.

Para obtener más información sobre los modelos Eloquent en la integración de Laravel, consulte SecciónModelos Elocuentes.

Recuperar documentos que coinciden con una consulta

Puede utilizar el mapeador relacional de objetos Eloquent (ORM) de Laravel para crear modelos que representen colecciones de MongoDB y encadenar métodos en ellos para especificar criterios de consulta.

Para recuperar documentos que coincidan con un conjunto de criterios, llame al método where() en el modelo Eloquent correspondiente de la colección y luego pase un filtro de consulta al método.

Un filtro de consulta especifica los requisitos de valores de campo e indica a la operación de búsqueda que devuelva únicamente los documentos que cumplan con estos requisitos.

Puede utilizar una de las siguientes llamadas al método where() para crear una consulta:

• where('<field name>', <value>) crea una consulta que coincide con los documentos en los que el campo de destino tiene el valor exacto especificado

• where('<field name>', '<comparison operator>', <value>) crea una consulta que coincide con los documentos en los que el valor del campo de destino cumple con los criterios de comparación

Para aplicar múltiples conjuntos de criterios a la operación de búsqueda, se puede encadenar una serie de métodos where() juntos.

Después de crear su consulta utilizando el método where(), encadene el método get() para recuperar los resultados de la consulta.

Este ejemplo llama a dos métodos where() en el modelo Eloquent Movie para recuperar documentos que cumplen los siguientes criterios:

• year El campo tiene un valor de 2010

• imdb.rating El campo anidado tiene un valor mayor que 8.5

$movies = Movie::where('year', 2010)
    ->where('imdb.rating', '>', 8.5)
    ->get();

class MovieController
{
    public function show()
    {
         $movies = Movie::where('year', 2010)
             ->where('imdb.rating', '>', 8.5)
             ->get();
         return view('browse_movies', [
             'movies' => $movies
         ]);
    }
}

Title: Inception
Year: 2010
Runtime: 148
IMDB Rating: 8.8
IMDB Votes: 1294646
Plot: A thief who steals corporate secrets through use of dream-sharing
technology is given the inverse task of planting an idea into the mind of a CEO.
Title: Senna
Year: 2010
Runtime: 106
IMDB Rating: 8.6
IMDB Votes: 41904
Plot: A documentary on Brazilian Formula One racing driver Ayrton Senna, who won the
F1 world championship three times before his death at age 34.

Para aprender a usar el generador de query de Laravel en lugar del ORM Eloquent, consulta la página de Generador de query.

$movies = Movie::where('countries', ['Indonesia', 'Canada'])
    ->get();

$movies = Movie::where('countries', 'in', ['Canada', 'Egypt'])
    ->get();

Recuperar el primer resultado

Para recuperar el primer documento que coincida con un conjunto de criterios, utilice el método where() seguido del método first().

Encadene el método orderBy() a first() para obtener resultados consistentes al consultar un valor único. Si omite el método orderBy(), MongoDB devuelve los documentos coincidentes según su orden natural o como aparecen en la colección.

Este ejemplo realiza una consulta de documentos en los que el valor del campo runtime es 30 y devuelve el primer documento coincidente según el valor del campo _id.

$movie = Movie::where('runtime', 30)
    ->orderBy('_id')
    ->first();

class MovieController
{
    public function show()
    {
        $movie = Movie::where('runtime', 30)
            ->orderBy('_id')
            ->first();
        return view('browse_movies', [
            'movies' => $movie
        ]);
    }
}

Title: Statues also Die
Year: 1953
Runtime: 30
IMDB Rating: 7.6
IMDB Votes: 620
Plot: A documentary of black art.

Recuperar todos los documentos de una colección

Puede recuperar todos los documentos de una colección omitiendo el filtro de consulta. Para obtener los documentos, llame al método get() en un modelo de Eloquent que represente su colección. Como alternativa, puede usar el alias all() del método get() para realizar la misma operación.

Utilice la siguiente sintaxis para ejecutar una operación de búsqueda que coincida con todos los documentos:

$movies = Movie::get();

Información Adicional

Para ver ejemplos de código ejecutables que demuestran cómo realizar operaciones de búsqueda mediante la integración de Laravel, consulte los siguientes ejemplos de uso:

• Buscar un documento

• Encuentra varios documentos

Para aprender cómo insertar datos en MongoDB, consulte la guía Operaciones de escritura.

Para aprender cómo modificar la forma en que la integración de Laravel devuelve resultados, consulte la guía Modificar resultados de consulta.