Retrieve Data

Visão geral

Neste guia, você pode aprender como recuperar dados de coleções MongoDB usando Laravel MongoDB. Este guia descreve os métodos do modelo Eloquent que você pode usar para recuperar dados e fornece exemplos de diferentes tipos de operações de localização.

Para saber mais sobre os modelos Eloquent na integração com o Laravel, consulte a seção Modelos Eloquent.

Recuperar documentos que correspondam a uma query

Você pode usar o mapeador objeto-relacional (ORM) Eloquent do Laravel para criar modelos que representam coleções do MongoDB e métodos de cadeia neles para especificar critérios de query.

Para recuperar documentos que correspondam a um conjunto de critérios, chame o método where() no modelo Eloquent correspondente da coleção e, em seguida, passe um filtro de query para o método.

Um filtro de query especifica os requisitos de valor do campo e instrui a operação de localização a retornar apenas documentos que atendam a esses requisitos.

Você pode utilizar uma das seguintes chamadas de método do where() para construir uma query:

• where('<field name>', <value>) cria uma consulta que corresponde a documentos nos quais o campo de destino tem o valor exato especificado

• where('<field name>', '<comparison operator>', <value>) cria uma query que corresponde a documentos em que o valor do campo de destino atende aos critérios de comparação

Para aplicar vários conjuntos de critérios à operação de localizar, você pode encadear uma série de métodos do where() juntos.

Após construir sua query utilizando o método where() , encadeie o método get() para recuperar os resultados da query.

Este exemplo chama dois métodos where() no modelo Movie Eloquent para recuperar documentos que atendam aos seguintes critérios:

• year campo tem um valor de 2010

• imdb.rating campo aninhado tem um valor maior 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 saber como executar queries usando o construtor de queries Laravel em vez do Eloquent ORM, consulte a página Construtor de queries.

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

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

Recuperar o primeiro resultado

Para recuperar o primeiro documento que corresponde a um conjunto de critérios, use o método where() seguido pelo método first() .

Encadeie o método orderBy() a first() para obter resultados consistentes ao fazer query de um valor único. Se você omitir o método orderBy() , o MongoDB retornará os documentos correspondentes de acordo com a ordem natural dos documentos ou como eles aparecem na coleção.

Este exemplo faz uma query em documentos em que o valor do campo runtime é 30 e retorna o primeiro documento correspondente de acordo com o valor do 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 os documentos de uma collection

Você pode recuperar todos os documento em uma collection omitindo o filtro de query. Para devolver os documentos, chame o método get() em um modelo Eloquent que representa sua coleção. Alternativamente, você pode utilizar o alias do método get() all() para executar a mesma operação.

Use a seguinte sintaxe para executar uma operação de busca que corresponda a todos os documentos:

$movies = Movie::get();

Informações adicionais

Para ver exemplos de código executável que demonstram como realizar operações de localização usando a integração com o Laravel, consulte os seguintes exemplos de uso:

• Encontrar um documento

• Localizar vários documentos

Para saber como inserir dados no MongoDB, consulte o guia Operações de gravação.

Para saber como modificar a maneira como a integração com o Laravel retorna resultados, consulte o guia Modificar resultados da query.