Collections
Introdução
A classe Illuminate\Support\Collection
um nativo, conveniente wrapper para trabalhar com arrays de dados. Por exemplo, dê uma olhada no seguinte código. Usaremos o helper collect
para criar uma nova instância de uma coleção a partir de um array:
$collection = collect(['taylor', 'abigail', null])->map(function($name)
{
return strtoupper($name);
})
->reject(function($name)
{
return empty($name);
});
Como você pode ver, a classe Collection
permite que você chame encadeadamento métodos para realizar nativamente mapeamento e redução do array subjacente. Em geral, todo método Collection
retorna uma nova instância inteira de Collection
. Para mais detalhes, continue lendo!
Uso Básico
Criado Coleções
Como mencionado acima, o helper collect
retornará uma nova instância de Illuminate\Support\Collection
para o array dado. Você pode também usar o comando make
na classe Collection
:
$collection = collect([1, 2, 3]);
$collection = Collection::make([1, 2, 3]);
É claro, que objetos de coleções Eloquent sempre retornam como instâncias de Collection
; contudo, você deve se sentir livre para usar a classe Collection
quando isto for conveniente para sua aplicação.
Explore a Coleção
Ao invés de listar todos os métodos (que são muitos) a Api de Collection
é disponibilizada, dê uma olhada na Na documentação da API para a classe!