collections.md

Collections

• Introduction
• Basic Usage

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!