</section>

<section class="cmd-description grid-item">

<h4><a name="collection" href="#collection">Collection</a> <a href="https://laravel.com/docs/5.1/collections" title="Collections CLI @ Laravel Docs"><i class="icon-file-text"></i></a></h4>

<pre class="prettyprint lang-php">

// Creating Collections

collect([1, 2, 3]);

// Simply returns the underlying array represented by the collection:

$collection->all();

// Returns the average of all items in the collection:

$collection->avg();

// Breaks the collection into multiple, smaller collections of a given size:

$collection->chunk(4);

// Collapses a collection of arrays into a flat collection:

$collection->collapse();

// Determines whether the collection contains a given item:

$collection->contains('New York');

// Returns the total number of items in the collection:

$collection->count();

// Iterates over the items in the collection and passes each item to a given callback:

$collection = $collection->each(function ($item, $key) {

});

// Creates a new collection consisting of every n-th element:

$collection->every(4);

// Pass offset as the second argument:

$collection->every(4, 1);

// Returns all items in the collection except for those with the specified keys:

$collection->except(['price', 'discount']);

// Filters the collection by a given callback:

$filtered = $collection->filter(function ($item) {

return $item > 2;

});

// Returns the first element in the collection that passes a given truth test:

collect([1, 2, 3, 4])->first(function ($key, $value) {

return $value > 2;

});

// Flattens a multi-dimensional collection into a single dimension:

$flattened = $collection->flatten();

// Swaps the collection's keys with their corresponding values:

$flipped = $collection->flip();

// Removes an item from the collection by its key:

$collection->forget('name');

// Returns a new collection containing the items:

$chunk = $collection->forPage(2, 3);

// Returns the item at a given key. If the key does not exist, null is returned:

$value = $collection->get('name');

// Groups the collection's items by a given key:

$grouped = $collection->groupBy('account_id');

// Determines if a given key exists in the collection:

$collection->has('email');

// Joins the items in a collection:

$collection->implode('product', ', ');

// Removes any values that are not present in the given array or collection:

$intersect = $collection->intersect(['Desk', 'Chair', 'Bookcase']);

// Returns true if the collection is empty:

collect([])->isEmpty();

// Keys the collection by the given key:

$keyed = $collection->keyBy('product_id');

// Pass a callback, which should return the value to key the collection by:

$keyed = $collection->keyBy(function ($item) {

return strtoupper($item['product_id']);

});

// Returns all of the collection's keys:

$keys = $collection->keys();

// Returns the last element in the collection:

$collection->last();

// Iterates through the collection and passes each value to the given callback:

$multiplied = $collection->map(function ($item, $key) {

return $item * 2;

});

// Return the maximum value of a given key:

$max = collect([['foo' => 10], ['foo' => 20]])->max('foo');

$max = collect([1, 2, 3, 4, 5])->max();

// Merges the given array into the collection:

$merged = $collection->merge(['price' => 100, 'discount' => false]);

// Return the minimum value of a given key:

$min = collect([['foo' => 10], ['foo' => 20]])->min('foo');

$min = collect([1, 2, 3, 4, 5])->min();

// Returns the items in the collection with the specified keys:

$filtered = $collection->only(['product_id', 'name']);

// Retrieves all of the collection values for a given key:

$plucked = $collection->pluck('name');

// Removes and returns the last item from the collection:

$collection->pop();

// Adds an item to the beginning of the collection:

$collection->prepend(0);

// Pass a second argument to set the key of the prepended item:

$collection->prepend(0, 'zero');

// Removes and returns an item from the collection by its key:

$collection->pull('name');

// Appends an item to the end of the collection:

$collection->push(5);

// Sets the given key and value in the collection:

$collection->put('price', 100);

// Returns a random item from the collection:

$collection->random();

// Pass an integer to random. If that integer is more than 1, a collection of items is returned:

$random = $collection->random(3);

// Reduces the collection to a single value:

$total = $collection->reduce(function ($carry, $item) {

return $carry + $item;

});

// Filters the collection using the given callback:

$filtered = $collection->reject(function ($item) {

return $item > 2;

});

// Reverses the order of the collection's items:

$reversed = $collection->reverse();

// Searches the collection for the given value and returns its key if found:

$collection->search(4);

// Removes and returns the first item from the collection:

$collection->shift();

// Randomly shuffles the items in the collection:

$shuffled = $collection->shuffle();

// Returns a slice of the collection starting at the given index:

$slice = $collection->slice(4);

// Sorts the collection:

$sorted = $collection->sort();

// Sorts the collection by the given key:

$sorted = $collection->sortBy('price');

// Removes and returns a slice of items starting at the specified index:

$chunk = $collection->splice(2);

// Returns the sum of all items in the collection:

collect([1, 2, 3, 4, 5])->sum();

// Returns a new collection with the specified number of items:

$chunk = $collection->take(3);

// Converts the collection into a plain PHP array:

$collection->toArray();

// Converts the collection into JSON:

$collection->toJson();

// Iterates over the collection:

$collection->transform(function ($item, $key) {

return $item * 2;

});

// Returns all of the unique items in the collection:

$unique = $collection->unique();

// Returns a new collection with the keys reset to consecutive integers:

$values = $collection->values();

// Filters the collection by a given key / value pair:

$filtered = $collection->where('price', 100);

// Merges together the values of the given array with the values of the collection:

$zipped = $collection->zip([100, 200]);

</pre>

</section>

</section>

<section class="cmd-description grid-item">

<h4><a name="collection" href="#collection">Collection</a> <a href="https://laravel.com/docs/5.1/collections" title="Collections CLI @ Laravel Docs"><i class="icon-file-text"></i></a></h4>

<pre class="prettyprint lang-php">

// 创建集合

collect([1, 2, 3]);

// 返回该集合所代表的底层数组：

$collection->all();

// 返回集合中所有项目的平均值：

$collection->avg();

// 将集合拆成多个给定大小的较小集合：

$collection->chunk(4);

// 将多个数组组成的集合折成单一数组集合：

$collection->collapse();

// 用来判断该集合是否含有指定的项目：

$collection->contains('New York');

// 返回该集合内的项目总数：

$collection->count();

// 遍历集合中的项目，并将之传入给定的回调函数：

$collection = $collection->each(function ($item, $key) {

});

// 会创建一个包含第 n 个元素的新集合：

$collection->every(4);

// 传递偏移值作为第二个参数：

$collection->every(4, 1);

// 返回集合中排除指定键的所有项目：

$collection->except(['price', 'discount']);

// 以给定的回调函数筛选集合，只留下那些通过判断测试的项目：

$filtered = $collection->filter(function ($item) {

return $item > 2;

});

// 返回集合中，第一个通过给定测试的元素：

collect([1, 2, 3, 4])->first(function ($key, $value) {

return $value > 2;

});

// 将多维集合转为一维集合：

$flattened = $collection->flatten();

// 将集合中的键和对应的数值进行互换：

$flipped = $collection->flip();

// 以键自集合移除掉一个项目：

$collection->forget('name');

// 返回含有可以用来在给定页码显示项目的新集合：

$chunk = $collection->forPage(2, 3);

// 返回给定键的项目。如果该键不存在，则返回 null：

$value = $collection->get('name');

// 根据给定的键替集合内的项目分组：

$grouped = $collection->groupBy('account_id');

// 用来确认集合中是否含有给定的键：

$collection->has('email');

// 用来连接集合中的项目

$collection->implode('product', ', ');

// 移除任何给定数组或集合内所没有的数值：

$intersect = $collection->intersect(['Desk', 'Chair', 'Bookcase']);

// 假如集合是空的，isEmpty 方法会返回 true：

collect([])->isEmpty();

// 以给定键的值作为集合项目的键：

$keyed = $collection->keyBy('product_id');

// 传入回调函数，该函数会返回集合的键的值：

$keyed = $collection->keyBy(function ($item) {

return strtoupper($item['product_id']);

});

// 返回该集合所有的键：

$keys = $collection->keys();

// 返回集合中，最后一个通过给定测试的元素：

$collection->last();

// 遍历整个集合并将每一个数值传入给定的回调函数：

$multiplied = $collection->map(function ($item, $key) {

return $item * 2;

});

// 返回给定键的最大值：

$max = collect([['foo' => 10], ['foo' => 20]])->max('foo');

$max = collect([1, 2, 3, 4, 5])->max();

// 将给定的数组合并进集合：

$merged = $collection->merge(['price' => 100, 'discount' => false]);

// 返回给定键的最小值：

$min = collect([['foo' => 10], ['foo' => 20]])->min('foo');

$min = collect([1, 2, 3, 4, 5])->min();

// 返回集合中指定键的所有项目：

$filtered = $collection->only(['product_id', 'name']);

// 获取所有集合中给定键的值：

$plucked = $collection->pluck('name');

// 移除并返回集合最后一个项目：

$collection->pop();

// 在集合前面增加一个项目：

$collection->prepend(0);

// 传递第二个参数来设置前置项目的键：

$collection->prepend(0, 'zero');

// 以键从集合中移除并返回一个项目：

$collection->pull('name');

// 附加一个项目到集合后面：

$collection->push(5);

// put 在集合内设置一个给定键和数值：

$collection->put('price', 100);

// 从集合中随机返回一个项目：

$collection->random();

// 传入一个整数到 random。如果该整数大于 1，则会返回一个集合：

$random = $collection->random(3);

// 会将每次迭代的结果传入到下一次迭代：

$total = $collection->reduce(function ($carry, $item) {

return $carry + $item;

});

// 以给定的回调函数筛选集合：

$filtered = $collection->reject(function ($item) {

return $item > 2;

});

// 反转集合内项目的顺序：

$reversed = $collection->reverse();

// 在集合内搜索给定的数值并返回找到的键：

$collection->search(4);

// 移除并返回集合的第一个项目：

$collection->shift();

// 随机排序集合的项目：

$shuffled = $collection->shuffle();

// 返回集合从给定索引开始的一部分切片：

$slice = $collection->slice(4);

// 对集合排序：

$sorted = $collection->sort();

// 以给定的键排序集合：

$sorted = $collection->sortBy('price');

// 移除并返回从指定的索引开始的一小切片项目：

$chunk = $collection->splice(2);

// 返回集合内所有项目的总和：

collect([1, 2, 3, 4, 5])->sum();

// 返回有着指定数量项目的集合：

$chunk = $collection->take(3);

// 将集合转换成纯 PHP 数组：

$collection->toArray();

// 将集合转换成 JSON：

$collection->toJson();

// 遍历集合并对集合内每一个项目调用给定的回调函数：

$collection->transform(function ($item, $key) {

return $item * 2;

});

// 返回集合中所有唯一的项目：

$unique = $collection->unique();

// 返回键重设为连续整数的的新集合：

$values = $collection->values();

// 以一对给定的键／数值筛选集合：

$filtered = $collection->where('price', 100);

// 将集合与给定数组同样索引的值合并在一起：

$zipped = $collection->zip([100, 200]);

</pre>

</section>