Retrieve Data

Overview

En esta guía, puedes aprender cómo recuperar datos de colecciones de MongoDB usando Laravel MongoDB. Esta guía describe los métodos de modelos Eloquent que puedes 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, consulta la 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 query especifica los requisitos de valor de campo e instruye a la operación de búsqueda para que devuelva solo los documentos que cumplan con estos requisitos.

Puede usar una de las siguientes where() llamadas de método para compilar una query:

• 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 superior a 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 cumpla un conjunto de criterios, utiliza 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 en una colección

Puedes recuperar todos los documentos de una colección omitiendo el filtro de query. Para devolver los documentos, llama al método get() en un modelo Eloquent que represente tu colección. De manera alternativa, puedes emplear el alias all() del método get() para llevar a cabo 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:

• Encuentra un documento

• Encuentra varios documentos

Para aprender a insertar datos en MongoDB, consulta la guía de 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.