Encontrar um documento

Você pode recuperar um único documento de uma coleção usando um método como Model::where() ou métodos da face DB para corresponder aos documentos e, em seguida, chamando o método first() para retornar um documento.

If multiple documents match the query filter, first() returns the first matching document according to the documents' natural order in the database or according to the sort order that you can specify by using the orderBy() method.

Dica

Para saber mais sobre outras maneiras de recuperar documentos com a integração do Laravel, consulte o guia Operações de leitura .

Exemplo

Selecione a partir das seguintes abas Eloquent e Query Builder para visualizar exemplos de uso para a mesma operação que usa cada sintaxe de query correspondente:

Este exemplo executa as seguintes ações:

Utiliza o modelo Movie Eloquent para representar a coleção do sample_mflix movies banco de dados do
Recupera um documento da coleção movies que corresponde a um filtro de query
Imprime o documento recuperado

O exemplo chama os seguintes métodos no modelo Movie :

where(): corresponde a documentos em que o valor do campo directors inclui "Rob Reiner"
orderBy(): classifica documentos correspondentes por seus valores de _id crescentes
first(): recupera somente o primeiro documento correspondente

$movie = Movie::where('directors', 'Rob Reiner')
  ->orderBy('id')
  ->first();
echo $movie->toJson();

// Result is truncated
{
  "_id": ...,
  "title": "This Is Spinal Tap",
  "directors": [ "Rob Reiner" ],
   ...
}

Este exemplo executa as seguintes ações:

Acessos a coleção movies chamando o método table() a partir da fase DB
Recupera um documento da coleção movies que corresponde a um filtro de query
Imprime o campo title do documento recuperado

O exemplo chama os seguintes métodos de construtor de query:

where(): corresponde a documentos em que o valor do campo directors inclui "Rob Reiner"
orderBy(): classifica documentos correspondentes por seus valores de _id crescentes
first(): recupera somente o primeiro documento correspondente

$movie = DB::table('movies')
  ->where('directors', 'Rob Reiner')
  ->orderBy('_id')
  ->first();
echo $movie['title'];

Para saber como editar seu aplicativo Laravel para executar o exemplo de uso, consulte a página de exemplos de uso.

Voltar

Exemplos de uso

Localizar vários documentos