Encontrar um documento
Você pode recuperar um único documento de uma coleção criando um construtor de consulta , usando um método como Model::where()
ou a face DB
para corresponder aos documentos em uma coleção e, em seguida, chamando o método first()
para retornar um documento..
Se vários documentos corresponderem ao filtro de query, first()
retornará o primeiro documento correspondente de acordo com aordem natural dos documentos no banco de banco de dados ou de acordo com a ordem de classificação que você pode especificar usando o método orderBy()
.
Exemplo
Este exemplo de uso executa as seguintes ações:
Utiliza o modelo
Movie
Eloquent para representar a coleção dosample_mflix
movies
banco de dados doRecupera um documento da coleção
movies
que corresponde a um filtro de queryImprime o documento recuperado
O exemplo chama os seguintes métodos no modelo Movie
:
where()
: corresponde a documentos em que o valor do campodirectors
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" ], ... }
Para saber como editar seu aplicação Laravel para executar o exemplo de uso, consulte apágina de destino Exemplos de uso .
Dica
Para saber mais sobre como recuperar documentos com a integração do Laravel, consulte o guia Operações de leitura .