Introduction
The Illuminate\Support\Collection
class provides a fluent, convenient wrapper for working with arrays of data. For example, check out the following code. We'll use the collect
helper to create a new collection instance from the array:
$collection = collect(['taylor', 'abigail', null])->map(function($name)
{
return strtoupper($name);
})
->reject(function($name)
{
return empty($name);
});
As you can see, the Collection
class allows you to chain its methods to perform fluent mapping and reducing of the underlying array. In general, every Collection
method returns an entirely new Collection
instance. To dig in further, keep reading!
Basic Usage
Creating Collections
As mentioned above, the collect
helper will return a new Illuminate\Support\Collection
instance for the given array. You may also use the make
command on the Collection
class:
$collection = collect([1, 2, 3]);
$collection = Collection::make([1, 2, 3]);
Of course, collections of Eloquent objects are always returned as Collection
instances; however, you should feel free to use the Collection
class wherever it is convenient for your application.
Explore The Collection
Instead of listing all of the methods (there are a lot) the Collection makes available, check out the API documentation for the class!