集合 ​

简介 ​

Illuminate\Support\Collection 类为处理数据数组提供了流利、便利的封装。例如，请查看以下代码。我们将使用 collect 辅助函数从数组创建新的 collection 实例，对每个元素运行 strtoupper 函数，然后移除所有空元素：

$collection = collect(['taylor', 'abigail', null])->map(function (?string $name) {
    return strtoupper($name);
})->reject(function (string $name) {
    return empty($name);
});

如您所见， Collection 类允许您链式调用其方法，以流畅地映射和简化底层数组。一般来说，collections 是不可变的，这意味着每个 Collection 方法都返回全新的 Collection 实例。

创建 Collections ​

正如上面提到的， collect 辅助函数为给定数组返回新的 Illuminate\Support\Collection 实例。因此，创建一个 collection 就像这样简单：

$collection = collect([1, 2, 3]);

扩展 Collections ​

Collections 是“可宏编程的”，这允许您在运行时向 Collection 类添加附加方法。 Illuminate\Support\Collection 类的 macro 方法接受一个闭包，该闭包在调用宏时将被执行。宏闭包可以通过 $this 访问 collection 的其他方法，就好像它是 collection 类的一个真实方法。例如，以下代码向 Collection 类添加了一个 toUpper 方法：

use Illuminate\Support\Collection;
use Illuminate\Support\Str;
Collection::macro('toUpper', function () {
    return $this->map(function (string $value) {
        return Str::upper($value);
$collection = collect(['first', 'second']);
$upper = $collection->toUpper();
// ['FIRST', 'SECOND']

通常，您应该在 服务提供者 的 boot 方法中声明 collection 宏。

宏参数 ​

如果需要，您可以定义接受额外参数的宏：

use Illuminate\Support\Collection;
use Illuminate\Support\Facades\Lang;
Collection::macro('toLocale', function (string $locale) {
    return $this->map(function (string $value) use ($locale) {
        return Lang::get($value, [], $locale);
$collection = collect(['first', 'second']);
$translated = $collection->toLocale('es');

方法列表 ​

all() ​

all 方法返回由 collection 表示的底层数组：

collect([1, 2, 3])->all();
// [1, 2, 3]

average() ​

average() 方法的别名。

avg() ​

avg 方法返回给定键的 平均值 ：

$average = collect([
    ['foo' => 10],
    ['foo' => 10],
    ['foo' => 20],
    ['foo' => 40]
])->avg('foo');
// 20
$average = collect([1, 1, 2, 4])->avg();
// 2

chunk() ​

chunk 方法将 collection 分解成多个更小的 collection，每个指定大小：

$collection = collect([1, 2, 3, 4, 5, 6, 7]);
$chunks = $collection->chunk(4);
$chunks->all();
// [[1, 2, 3, 4], [5, 6, 7]]

此方法在使用如 Bootstrap 这样的网格系统的 views 中特别有用。例如，想象你有一组 Eloquent 模型，你想在网格中显示：

@foreach ($products->chunk(3) as $chunk)
    <div class="row">
        @foreach ($chunk as $product)
            <div class="col-xs-4">{{ $product->name }}</div>
        @endforeach
    </div>
@endforeach

chunkWhile() ​

chunkWhile 方法基于给定回调的评估将 collection 分解成多个更小的 collection。传递给闭包的 $chunk 变量可用于检查前一个元素：

$collection = collect(str_split('AABBCCCD'));
$chunks = $collection->chunkWhile(function (string $value, int $key, Collection $chunk) {
    return $value === $chunk->last();
$chunks->all();
// [['A', 'A'], ['B', 'B'], ['C', 'C', 'C'], ['D']]

collapse() ​

collapse 方法将数组的 collection 折叠成一个平坦的单一 collection：

$collection = collect([
    [1, 2, 3],
    [4, 5, 6],
    [7, 8, 9],
$collapsed = $collection->collapse();
$collapsed->all();
// [1, 2, 3, 4, 5, 6, 7, 8, 9]

collect() ​

collect 方法使用当前 collection 中的项目返回一个新的 Collection 实例：

$collectionA = collect([1, 2, 3]);
$collectionB = $collectionA->collect();
$collectionB->all();
// [1, 2, 3]

collect 方法主要用于将 懒惰 collections 转换为标准 Collection 实例：

$lazyCollection = LazyCollection::make(function () {
    yield 1;
    yield 2;
    yield 3;
$collection = $lazyCollection->collect();
$collection::class;
// 'Illuminate\Support\Collection'
$collection->all();
// [1, 2, 3]

combine() ​

combine 方法将 collection 的值作为键与另一个数组或 collection 的值结合：

$collection = collect(['name', 'age']);
$combined = $collection->combine(['George', 29]);
$combined->all();
// ['name' => 'George', 'age' => 29]

concat() ​

concat 方法将给定 array 或 collection 的值附加到另一个 collection 的末尾：

$collection = collect(['John Doe']);
$concatenated = $collection->concat(['Jane Doe'])->concat(['name' => 'Johnny Doe']);
$concatenated->all();
// ['John Doe', 'Jane Doe', 'Johnny Doe']

concat 方法为附加到原始 collection 的项目重新索引键。若要在关联 collections 中维护键，请参见 merge 方法。

contains() ​

contains 方法确定 collection 是否包含给定项目。您可以传递一个闭包给 contains 方法来确定 collection 中是否存在与给定真实测试匹配的元素：

$collection = collect([1, 2, 3, 4, 5]);
$collection->contains(function (int $value, int $key) {
    return $value > 5;
// false

或者，您可以传递一个字符串给 contains 方法来确定 collection 是否包含给定项目值：

$collection = collect(['name' => 'Desk', 'price' => 100]);
$collection->contains('Desk');
// true
$collection->contains('New York');
// false

您也可以传递一个键/值对给 contains 方法，它将确定给定对是否存在于 collection 中：

$collection = collect([
    ['product' => 'Desk', 'price' => 200],
    ['product' => 'Chair', 'price' => 100],
$collection->contains('product', 'Bookcase');
// false

contains 方法在检查项目值时使用“松散”比较，意味着具有整数值的字符串将被认为等于同一值的整数。使用 containsStrict 方法使用“严格”比较进行筛选。

contains 的相反方法，参见 doesntContain 方法。

containsOneItem() ​

containsOneItem 方法确定 collection 是否仅包含一个项目：

collect([])->containsOneItem();
// false
collect(['1'])->containsOneItem();
// true
collect(['1', '2'])->containsOneItem();
// false

containsStrict() ​

此方法与 contains 方法具有相同的签名；然而，所有值都使用“严格”比较进行比较。

count() ​

count 方法返回 collection 中项目的总数：

$collection = collect([1, 2, 3, 4]);
$collection->count();
// 4

countBy() ​

countBy 方法计算 collection 中值的出现次数。默认情况下，该方法计算每个元素的出现次数，允许您计算 collection 中某些“类型”的元素：

$collection = collect([1, 2, 2, 2, 3]);
$counted = $collection->countBy();
$counted->all();
// [1 => 1, 2 => 3, 3 => 1]

您通过闭包将闭包传递给 countBy 方法来按自定义值统计所有项目：

$collection = collect(['[email protected]', '[email protected]', '[email protected]']);
$counted = $collection->countBy(function (string $email) {
    return substr(strrchr($email, "@"), 1);
$counted->all();
// ['gmail.com' => 2, 'yahoo.com' => 1]

crossJoin() ​

crossJoin 方法在给定的数组或 collections 中交叉连接 collection 的值，返回所有可能排列的笛卡尔积：

$collection = collect([1, 2]);
$matrix = $collection->crossJoin(['a', 'b']);
$matrix->all();
        [1, 'a'],
        [1, 'b'],
        [2, 'a'],
        [2, 'b'],
$collection = collect([1, 2]);
$matrix = $collection->crossJoin(['a', 'b'], ['I', 'II']);
$matrix->all();
        [1, 'a', 'I'],
        [1, 'a', 'II'],
        [1, 'b', 'I'],
        [1, 'b', 'II'],
        [2, 'a', 'I'],
        [2, 'a', 'II'],
        [2, 'b', 'I'],
        [2, 'b', 'II'],
*/

dd() ​

dd 方法打印 collection 的项目并结束脚本执行：

$collection = collect(['John Doe', 'Jane Doe']);
$collection->dd();
    Collection {
        #items: array:2 [
            0 => "John Doe"
            1 => "Jane Doe"
*/

如果您不想在打印 collection 之后停止执行脚本，请改用 dump 方法。

diff() ​

diff 方法基于值将 collection 与另一个 collection 或纯 PHP array 进行比较。此方法将返回原始 collection 中未出现在给定 collection 中的值：

$collection = collect([1, 2, 3, 4, 5]);
$diff = $collection->diff([2, 4, 6, 8]);
$diff->all();
// [1, 3, 5]

diffAssoc() ​

diffAssoc 方法基于键和值将 collection 与另一个 collection 或纯 PHP array 进行比较。此方法将返回原始 collection 中未出现在给定 collection 中的键值对：

$collection = collect([
    'color' => 'orange',
    'type' => 'fruit',
    'remain' => 6,
$diff = $collection->diffAssoc([
    'color' => 'yellow',
    'type' => 'fruit',
    'remain' => 3,
    'used' => 6,
$diff->all();
// ['color' => 'orange', 'remain' => 6]

diffAssocUsing() ​

与 diffAssoc 不同， diffAssocUsing 接受一个由用户提供的回调函数用于索引比较：

$collection = collect([
    'color' => 'orange',
    'type' => 'fruit',
    'remain' => 6,
$diff = $collection->diffAssocUsing([
    'Color' => 'yellow',
    'Type' => 'fruit',
    'Remain' => 3,
], 'strnatcasecmp');
$diff->all();
// ['color' => 'orange', 'remain' => 6]

回调必须是一个返回小于、等于或大于零的整数的比较函数。有关更多信息，请参阅 PHP array_diff_uassoc 文档，这是 diffAssocUsing 方法内部使用的 PHP 函数。

diffKeys() ​

diffKeys 方法基于键将 collection 与另一个 collection 或纯 PHP array 进行比较。此方法将返回原始 collection 中未出现在给定 collection 中的键值对：

$collection = collect([
    'one' => 10,
    'two' => 20,
    'three' => 30,
    'four' => 40,
    'five' => 50,
$diff = $collection->diffKeys([
    'two' => 2,
    'four' => 4,
    'six' => 6,
    'eight' => 8,
$diff->all();
// ['one' => 10, 'three' => 30, 'five' => 50]

doesntContain() ​

doesntContain 方法确定 collection 是否不包含给定项目。您可以传递一个闭包给 doesntContain 方法来确定 collection 中是否不存在与给定真实测试匹配的元素：

$collection = collect([1, 2, 3, 4, 5]);
$collection->doesntContain(function (int $value, int $key) {
    return $value < 5;
// false

或者，您可以传递一个字符串给 doesntContain 方法来确定 collection 是否不包含给定项目值：

$collection = collect(['name' => 'Desk', 'price' => 100]);
$collection->doesntContain('Table');
// true
$collection->doesntContain('Desk');
// false

您也可以传递一个键/值对给 doesntContain 方法，它将确定给定对是否不存在于 collection 中：

$collection = collect([
    ['product' => 'Desk', 'price' => 200],
    ['product' => 'Chair', 'price' => 100],
$collection->doesntContain('product', 'Bookcase');
// true

doesntContain 方法在检查项目值时使用 "松散" 比较，意味着一个具有整数值的字符串将被认为等同于同一值的整数。

dot() ​

dot 方法将多维 collection 展平成单一层级 collection，使用 "点" 符号表示深度：

$collection = collect(['products' => ['desk' => ['price' => 100]]]);
$flattened = $collection->dot();
$flattened->all();
// ['products.desk.price' => 100]

dump() ​

dump 方法打印 collection 的项目：

$collection = collect(['John Doe', 'Jane Doe']);
$collection->dump();
    Collection {
        #items: array:2 [
            0 => "John Doe"
            1 => "Jane Doe"
*/

如果您想在打印 collection 后停止执行脚本，请改用 dd 方法。

duplicates() ​

duplicates 方法检索并返回 collection 中的重复值：

$collection = collect(['a', 'b', 'a', 'c', 'b']);
$collection->duplicates();
// [2 => 'a', 4 => 'b']

如果 collection 包含数组或对象，您可以传递您希望检查重复值的属性的键：

$employees = collect([
    ['email' => '[email protected]', 'position' => 'Developer'],
    ['email' => '[email protected]', 'position' => 'Designer'],
    ['email' => '[email protected]', 'position' => 'Developer'],
$employees->duplicates('position');
// [2 => 'Developer']

duplicatesStrict() ​

此方法与 duplicates 方法签名相同；然而，所有值都通过 "严格" 比较进行比较。

each() ​

each 方法迭代 collection 中的项目，并将每个项目传递给闭包：

$collection = collect([1, 2, 3, 4]);
$collection->each(function (int $item, int $key) {
    // ...
});

如果您想停止迭代项目，您可以从闭包返回 false ：

$collection->each(function (int $item, int $key) {
    if (/* condition */) {
        return false;
});

eachSpread() ​

eachSpread 方法迭代 collection 的项目，将每个嵌套的项目值传递给给定的回调：

$collection = collect([['John Doe', 35], ['Jane Doe', 33]]);
$collection->eachSpread(function (string $name, int $age) {
    // ...
});

您可以通过从回调返回 false 来停止迭代项目：

$collection->eachSpread(function (string $name, int $age) {
    return false;
});

ensure() ​

ensure 方法可用于验证 collection 的所有元素是否为给定类型或类型列表。否则，将抛出 UnexpectedValueException ：

return $collection->ensure(User::class);
return $collection->ensure([User::class, Customer::class]);

也可以指定 string 、 int 、 float 、 bool 和 array 等原始类型：

return $collection->ensure('int');

every() ​

every 方法可用于验证 collection 的所有元素是否通过给定真实测试：

collect([1, 2, 3, 4])->every(function (int $value, int $key) {
    return $value > 2;
// false

如果 collection 为空， every 方法将返回 true：

$collection = collect([]);
$collection->every(function (int $value, int $key) {
    return $value > 2;
// true

except() ​

except 方法返回除具有指定键的所有项目以外的 collection 中的所有项目：

$collection = collect(['product_id' => 1, 'price' => 100, 'discount' => false]);
$filtered = $collection->except(['price', 'discount']);
$filtered->all();
// ['product_id' => 1]

与 except 相反的方法，请参阅 only 方法。

filter() ​

filter 方法使用给定的回调过滤 collection，只保留通过给定真实测试的项目：

$collection = collect([1, 2, 3, 4]);
$filtered = $collection->filter(function (int $value, int $key) {
    return $value > 2;
$filtered->all();
// [3, 4]

如果没有提供回调，所有等同于 false 的 collection 条目都将被移除：

$collection = collect([1, 2, 3, null, false, '', 0, []]);
$collection->filter()->all();
// [1, 2, 3]

与 filter 相反的方法，请参阅 reject 方法。

first() ​

first 方法返回集合中通过给定真实测试的第一个元素：

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

您也可以无需任何参数调用 first 方法来获取集合中的第一个元素。如果集合为空，则返回 null ：

collect([1, 2, 3, 4])->first();
// 1

firstOrFail() ​

firstOrFail 方法与 first 方法相同；然而，如果没有找到结果，则会抛出 Illuminate\Support\ItemNotFoundException 异常：

collect([1, 2, 3, 4])->firstOrFail(function (int $value, int $key) {
    return $value > 5;
// 抛出 ItemNotFoundException...

您也可以无需任何参数调用 firstOrFail 方法来获取集合中的第一个元素。如果集合为空，则抛出 Illuminate\Support\ItemNotFoundException 异常：

collect([])->firstOrFail();
// 抛出 ItemNotFoundException...

firstWhere() ​

firstWhere 方法返回集合中具有给定键/值对的第一个元素：

$collection = collect([
    ['name' => 'Regena', 'age' => null],
    ['name' => 'Linda', 'age' => 14],
    ['name' => 'Diego', 'age' => 23],
    ['name' => 'Linda', 'age' => 84],
$collection->firstWhere('name', 'Linda');
// ['name' => 'Linda', 'age' => 14]

您也可以使用比较运算符调用 firstWhere 方法：

$collection->firstWhere('age', '>=', 18);
// ['name' => 'Diego', 'age' => 23]

像 where 方法一样，您可以传递一个参数给 firstWhere 方法。在这种情况下， firstWhere 方法将返回第一个给定项键的值为 "真实" 的项：

$collection->firstWhere('age');
// ['name' => 'Linda', 'age' => 14]

flatMap() ​

flatMap 方法遍历集合并将每个值传递给给定闭包。闭包可以自由修改项并返回它，从而形成一个新的修改过的项集合。然后，数组通过一层级展平：

$collection = collect([
    ['name' => 'Sally'],
    ['school' => 'Arkansas'],
    ['age' => 28]
$flattened = $collection->flatMap(function (array $values) {
    return array_map('strtoupper', $values);
$flattened->all();
// ['name' => 'SALLY', 'school' => 'ARKANSAS', 'age' => '28'];

flatten() ​

flatten 方法将多维集合展平为单一维度：

$collection = collect([
    'name' => 'taylor',
    'languages' => [
        'php', 'javascript'
$flattened = $collection->flatten();
$flattened->all();
// ['taylor', 'php', 'javascript'];

如有需要，您可以给 flatten 方法传递一个 "深度" 参数：

$collection = collect([
    'Apple' => [
            'name' => 'iPhone 6S',
            'brand' => 'Apple'
    'Samsung' => [
            'name' => 'Galaxy S7',
            'brand' => 'Samsung'
$products = $collection->flatten(1);
$products->values()->all();
        ['name' => 'iPhone 6S', 'brand' => 'Apple'],
        ['name' => 'Galaxy S7', 'brand' => 'Samsung'],
*/

在这个例子中，如果不提供深度调用 flatten 也会展平嵌套数组，结果为 ['iPhone 6S', 'Apple', 'Galaxy S7', 'Samsung'] 。提供深度允许您指定将展平的嵌套数组的级别数。

flip() ​

flip 方法交换集合键与它们对应的值：

$collection = collect(['name' => 'taylor', 'framework' => 'laravel']);
$flipped = $collection->flip();
$flipped->all();
// ['taylor' => 'name', 'laravel' => 'framework']

forget() ​

forget 方法通过其键从集合中移除一个项：

$collection = collect(['name' => 'taylor', 'framework' => 'laravel']);
$collection->forget('name');
$collection->all();
// ['framework' => 'laravel']

forPage() ​

forPage 方法返回一个新的集合，包含给定页面号码上应出现的项。该方法接受页面号码作为其第一个参数，以及每页显示的项数作为其第二个参数：

$collection = collect([1, 2, 3, 4, 5, 6, 7, 8, 9]);
$chunk = $collection->forPage(2, 3);
$chunk->all();
// [4, 5, 6]

get() ​

get 方法返回给定键的项。如果键不存在，则返回 null ：

$collection = collect(['name' => 'taylor', 'framework' => 'laravel']);
$value = $collection->get('name');
// taylor

您可以选择性地将默认值作为第二个参数传递：

$collection = collect(['name' => 'taylor', 'framework' => 'laravel']);
$value = $collection->get('age', 34);
// 34

您甚至可以将回调作为方法的默认值传递。如果指定的键不存在，将返回回调的结果：

$collection->get('email', function () {
    return '[email protected]';
// [email protected]

groupBy() ​

groupBy 方法将集合的项按给定的键分组：

$collection = collect([
    ['account_id' => 'account-x10', 'product' => 'Chair'],
    ['account_id' => 'account-x10', 'product' => 'Bookcase'],
    ['account_id' => 'account-x11', 'product' => 'Desk'],
$grouped = $collection->groupBy('account_id');
$grouped->all();
        'account-x10' => [
            ['account_id' => 'account-x10', 'product' => 'Chair'],
            ['account_id' => 'account-x10', 'product' => 'Bookcase'],
        'account-x11' => [
            ['account_id' => 'account-x11', 'product' => 'Desk'],
*/

而不是传递字符串 key ，你可以传递一个回调。回调应该返回你希望键入分组的值：

$grouped = $collection->groupBy(function (array $item, int $key) {
    return substr($item['account_id'], -3);
$grouped->all();
        'x10' => [
            ['account_id' => 'account-x10', 'product' => 'Chair'],
            ['account_id' => 'account-x10', 'product' => 'Bookcase'],
        'x11' => [
            ['account_id' => 'account-x11', 'product' => 'Desk'],
*/

可以将多个分组标准作为数组传递。每个数组元素将应用到多维数组中相应的级别：

$data = new Collection([
    10 => ['user' => 1, 'skill' => 1, 'roles' => ['Role_1', 'Role_3']],
    20 => ['user' => 2, 'skill' => 1, 'roles' => ['Role_1', 'Role_2']],
    30 => ['user' => 3, 'skill' => 2, 'roles' => ['Role_1']],
    40 => ['user' => 4, 'skill' => 2, 'roles' => ['Role_2']],
$result = $data->groupBy(['skill', function (array $item) {
    return $item['roles'];
}], preserveKeys: true);
    1 => [
        'Role_1' => [
            10 => ['user' => 1, 'skill' => 1, 'roles' => ['Role_1', 'Role_3']],
            20 => ['user' => 2, 'skill' => 1, 'roles' => ['Role_1', 'Role_2']],
        'Role_2' => [
            20 => ['user' => 2, 'skill' => 1, 'roles' => ['Role_1', 'Role_2']],
        'Role_3' => [
            10 => ['user' => 1, 'skill' => 1, 'roles' => ['Role_1', 'Role_3']],
    2 => [
        'Role_1' => [
            30 => ['user' => 3, 'skill' => 2, 'roles' => ['Role_1']],
        'Role_2' => [
            40 => ['user' => 4, 'skill' => 2, 'roles' => ['Role_2']],
*/

has() ​

has 方法确定集合中是否存在给定的键：

$collection = collect(['account_id' => 1, 'product' => 'Desk', 'amount' => 5]);
$collection->has('product');
// true
$collection->has(['product', 'amount']);
// true
$collection->has(['amount', 'price']);
// false

hasAny() ​

hasAny 方法确定集合中是否存在任何给定键：

$collection = collect(['account_id' => 1, 'product' => 'Desk', 'amount' => 5]);
$collection->hasAny(['product', 'price']);
// true
$collection->hasAny(['name', 'price']);
// false

implode() ​

implode 方法连接集合中的项目。其参数取决于集合中项目的类型。如果集合包含数组或对象，则应传递你希望连接的属性键，以及你希望放置在值之间的“粘合”字符串：

$collection = collect([
    ['account_id' => 1, 'product' => 'Desk'],
    ['account_id' => 2, 'product' => 'Chair'],
$collection->implode('product', ', ');
// Desk, Chair

如果集合包含简单字符串或数值，你应该将“粘合”作为方法的唯一参数传递：

collect([1, 2, 3, 4, 5])->implode('-');
// '1-2-3-4-5'

如果你想要格式化正在连接的值，你可以将一个闭包传递给 implode 方法：

$collection->implode(function (array $item, int $key) {
    return strtoupper($item['product']);
}, ', ');
// DESK, CHAIR

intersect() ​

intersect 方法从原始集合中移除任何在给定的 array 或集合中不存在的值。生成的集合将保留原始集合的键：

$collection = collect(['Desk', 'Sofa', 'Chair']);
$intersect = $collection->intersect(['Desk', 'Chair', 'Bookcase']);
$intersect->all();
// [0 => 'Desk', 2 => 'Chair']

intersectAssoc() ​

intersectAssoc 方法根据原始集合与另一个集合或 array 进行比较，返回存在于所有给定集合中的键/值对：

$collection = collect([
    'color' => 'red',
    'size' => 'M',
    'material' => 'cotton'
$intersect = $collection->intersectAssoc([
    'color' => 'blue',
    'size' => 'M',
    'material' => 'polyester'
$intersect->all();
// ['size' => 'M']

intersectByKeys() ​

intersectByKeys 方法从原始集合中移除任何在给定的 array 或集合中不存在的键及其对应的值：

$collection = collect([
    'serial' => 'UX301', 'type' => 'screen', 'year' => 2009,
$intersect = $collection->intersectByKeys([
    'reference' => 'UX404', 'type' => 'tab', 'year' => 2011,
$intersect->all();
// ['type' => 'screen', 'year' => 2009]

isEmpty() ​

isEmpty 方法如果集合为空返回 true ；否则，返回 false ：

collect([])->isEmpty();
// true

isNotEmpty() ​

isNotEmpty 方法如果集合不为空则返回 true ；否则，返回 false ：

collect([])->isNotEmpty();
// false

join() ​

join 方法使用字符串连接集合中的值。使用这个方法的第二个参数，你还可以指定如何将最终元素附加到字符串上：

collect(['a', 'b', 'c'])->join(', '); // 'a, b, c'
collect(['a', 'b', 'c'])->join(', ', ', and '); // 'a, b, and c'
collect(['a', 'b'])->join(', ', ' and '); // 'a and b'
collect(['a'])->join(', ', ' and '); // 'a'
collect([])->join(', ', ' and '); // ''

keyBy() ​

keyBy 方法根据给定键对集合进行键设置。如果多个项目有相同的键，只有最后一个会出现在新集合中：

$collection = collect([
    ['product_id' => 'prod-100', 'name' => 'Desk'],
    ['product_id' => 'prod-200', 'name' => 'Chair'],
$keyed = $collection->keyBy('product_id');
$keyed->all();
        'prod-100' => ['product_id' => 'prod-100', 'name' => 'Desk'],
        'prod-200' => ['product_id' => 'prod-200', 'name' => 'Chair'],
*/

你也可以传递一个回调函数给这个方法。回调函数应该返回用于键设置集合的值：

$keyed = $collection->keyBy(function (array $item, int $key) {
    return strtoupper($item['product_id']);
$keyed->all();
        'PROD-100' => ['product_id' => 'prod-100', 'name' => 'Desk'],
        'PROD-200' => ['product_id' => 'prod-200', 'name' => 'Chair'],
*/

keys() ​

keys 方法返回集合的所有键：

$collection = collect([
    'prod-100' => ['product_id' => 'prod-100', 'name' => 'Desk'],
    'prod-200' => ['product_id' => 'prod-200', 'name' => 'Chair'],
$keys = $collection->keys();
$keys->all();
// ['prod-100', 'prod-200']

last() ​

last 方法返回集合中通过给定真理测试的最后一个元素：

collect([1, 2, 3, 4])->last(function (int $value, int $key) {
    return $value < 3;
// 2

你也可以不带参数调用 last 方法来获取集合中的最后一个元素。如果集合为空，则返回 null ：

collect([1, 2, 3, 4])->last();
// 4

lazy() ​

lazy 方法从底层的条目数组中返回一个新的 LazyCollection 实例：

$lazyCollection = collect([1, 2, 3, 4])->lazy();
$lazyCollection::class;
// Illuminate\Support\LazyCollection
$lazyCollection->all();
// [1, 2, 3, 4]

当你需要对包含很多条目的巨大 Collection 执行转换时，这特别有用：

$count = $hugeCollection
    ->lazy()
    ->where('country', 'FR')
    ->where('balance', '>', '100')
    ->count();

通过将集合转换为 LazyCollection ，我们避免了分配大量额外的内存。尽管原始集合仍保持着它的值在内存中，但随后的过滤不会。因此，在过滤集合结果时几乎不会分配额外的内存。

macro() ​

静态 macro 方法允许你在运行时向 Collection 类添加方法。有关详细信息，请参阅关于 扩展 collections 的文档。

make() ​

静态 make 方法创建一个新的集合实例。参见 创建 Collections 部分。

map() ​

map 方法遍历集合并将每个值传递给给定的回调函数。回调函数可以自由地修改项目并返回它，从而形成一个新的修改后的项目集合：

$collection = collect([1, 2, 3, 4, 5]);
$multiplied = $collection->map(function (int $item, int $key) {
    return $item * 2;
$multiplied->all();
// [2, 4, 6, 8, 10]

mapInto() ​

mapInto() 方法遍历集合，为给定的类的每个新实例创建一个新实例，通过将值传递给构造函数：

class Currency
     * 创建一个新的 currency 实例。
    function __construct(
        public string $code
$collection = collect(['USD', 'EUR', 'GBP']);
$currencies = $collection->mapInto(Currency::class);
$currencies->all();
// [Currency('USD'), Currency('EUR'), Currency('GBP')]

mapSpread() ​

mapSpread 方法遍历集合的项目，将每个嵌套的项目值传递给给定的闭包。闭包可以自由地修改项目并返回它，从而形成一个新的修改后的条目集合：

$collection = collect([0, 1, 2, 3, 4, 5, 6, 7, 8, 9]);
$chunks = $collection->chunk(2);
$sequence = $chunks->mapSpread(function (int $even, int $odd) {
    return $even + $odd;
$sequence->all();
// [1, 5, 9, 13, 17]

mapToGroups() ​

mapToGroups 方法根据给定的闭包对集合的条目进行分组。闭包应返回包含单个键/值对的关联数组，从而形成一个新的分组值集合：

$collection = collect([
        'name' => 'John Doe',
        'department' => 'Sales',
        'name' => 'Jane Doe',
        'department' => 'Sales',
        'name' => 'Johnny Doe',
        'department' => 'Marketing',
$grouped = $collection->mapToGroups(function (array $item, int $key) {
    return [$item['department'] => $item['name']];
$grouped->all();
        'Sales' => ['John Doe', 'Jane Doe'],
        'Marketing' => ['Johnny Doe'],
$grouped->get('Sales')->all();
// ['John Doe', 'Jane Doe']

mapWithKeys() ​

mapWithKeys 方法遍历集合并将每个值传递给给定的回调函数。回调函数应返回包含单个键/值对的关联数组：

$collection = collect([
        'name' => 'John',
        'department' => 'Sales',
        'email' => '[email protected]',
        'name' => 'Jane',
        'department' => 'Marketing',
        'email' => '[email protected]',
$keyed = $collection->mapWithKeys(function (array $item, int $key) {
    return [$item['email'] => $item['name']];
$keyed->all();
        '[email protected]' => 'John',
        '[email protected]' => 'Jane',
*/

max() ​

max 方法返回给定键的最大值：

$max = collect([
    ['foo' => 10],
    ['foo' => 20]
])->max('foo');
// 20
$max = collect([1, 2, 3, 4, 5])->max();
// 5

median() ​

median 方法返回给定键的 中位数值 ：

$median = collect([
    ['foo' => 10],
    ['foo' => 10],
    ['foo' => 20],
    ['foo' => 40]
])->median('foo');
// 15
$median = collect([1, 1, 2, 4])->median();
// 1.5

merge() ​

merge 方法将给定的数组或集合与原始集合合并。如果给定条目中的字符串键与原始集合中的字符串键匹配，则给定条目的值将覆盖原始集合中的值：

$collection = collect(['product_id' => 1, 'price' => 100]);
$merged = $collection->merge(['price' => 200, 'discount' => false]);
$merged->all();
// ['product_id' => 1, 'price' => 200, 'discount' => false]

如果给定条目的键是数字，则值将附加到集合的末尾：

$collection = collect(['Desk', 'Chair']);
$merged = $collection->merge(['Bookcase', 'Door']);
$merged->all();
// ['Desk', 'Chair', 'Bookcase', 'Door']

mergeRecursive() ​

mergeRecursive 方法将给定的数组或集合与原始集合递归合并。如果给定条目中的字符串键与原始集合中的字符串键匹配，则这些键的值将合并到一个数组中，这一操作是递归进行的：

$collection = collect(['product_id' => 1, 'price' => 100]);
$merged = $collection->mergeRecursive([
    'product_id' => 2,
    'price' => 200,
    'discount' => false
$merged->all();
// ['product_id' => [1, 2], 'price' => [100, 200], 'discount' => false]

min() ​

min 方法返回给定键的最小值：

$min = collect([['foo' => 10], ['foo' => 20]])->min('foo');
// 10
$min = collect([1, 2, 3, 4, 5])->min();
// 1

mode() ​

mode 方法返回给定键的 众数值 ：

$mode = collect([
    ['foo' => 10],
    ['foo' => 10],
    ['foo' => 20],
    ['foo' => 40]
])->mode('foo');
// [10]
$mode = collect([1, 1, 2, 4])->mode();
// [1]
$mode = collect([1, 1, 2, 2])->mode();
// [1, 2]

nth() ​

nth 方法创建一个新的集合，包含每第 n 个元素：

$collection = collect(['a', 'b', 'c', 'd', 'e', 'f']);
$collection->nth(4);
// ['a', 'e']

你可以可选地传递第二个参数作为开始的偏移量：

$collection->nth(4, 1);
// ['b', 'f']

only() ​

only 方法返回集合中具有指定键的项：

$collection = collect([
    'product_id' => 1,
    'name' => 'Desk',
    'price' => 100,
    'discount' => false
$filtered = $collection->only(['product_id', 'name']);
$filtered->all();
// ['product_id' => 1, 'name' => 'Desk']

only 方法的逆过程，请参见 except 方法。

pad() ​

pad 方法将给定值填充到数组中，直到数组达到指定的大小。该方法的行为类似于 PHP 的 array_pad 函数。

要向左填充，你应该指定一个负的大小。如果给定大小的绝对值小于或等于数组的长度，则不进行填充：

$collection = collect(['A', 'B', 'C']);
$filtered = $collection->pad(5, 0);
$filtered->all();
// ['A', 'B', 'C', 0, 0]
$filtered = $collection->pad(-5, 0);
$filtered->all();
// [0, 0, 'A', 'B', 'C']

partition() ​

partition 方法可以与 PHP 数组解构结合使用，以将通过给定真理测试的元素与不通过的元素分隔开：

$collection = collect([1, 2, 3, 4, 5, 6]);
[$underThree, $equalOrAboveThree] = $collection->partition(function (int $i) {
    return $i < 3;
$underThree->all();
// [1, 2]
$equalOrAboveThree->all();
// [3, 4, 5, 6]

percentage() ​

percentage 方法可用于快速确定集合中通过给定真理测试的项目的百分比：

$collection = collect([1, 1, 2, 2, 2, 3]);
$percentage = $collection->percentage(fn ($value) => $value === 1);
// 33.33

默认情况下，百分比将四舍五入到两位小数。但是，你可以通过向方法提供第二个参数来自定义这个行为：

$percentage = $collection->percentage(fn ($value) => $value === 1, precision: 3);
// 33.333

pipe() ​

pipe 方法将集合传递给给定闭包，并返回执行闭包的结果：

$collection = collect([1, 2, 3]);
$piped = $collection->pipe(function (Collection $collection) {
    return $collection->sum();
// 6

pipeInto() ​

pipeInto 方法创建指定类的新实例，并将集合传入构造函数：

class ResourceCollection
     * 创建一个新 ResourceCollection 实例。
    public function __construct(
      public Collection $collection,
$collection = collect([1, 2, 3]);
$resource = $collection->pipeInto(ResourceCollection::class);
$resource->collection->all();
// [1, 2, 3]

pipeThrough() ​

pipeThrough 方法将集合传递给给定的闭包数组，并返回执行闭包的结果：

use Illuminate\Support\Collection;
$collection = collect([1, 2, 3]);
$result = $collection->pipeThrough([
    function (Collection $collection) {
        return $collection->merge([4, 5]);
    function (Collection $collection) {
        return $collection->sum();
// 15

pluck() ​

pluck 方法检索给定键的所有值：

$collection = collect([
    ['product_id' => 'prod-100', 'name' => 'Desk'],
    ['product_id' => 'prod-200', 'name' => 'Chair'],
$plucked = $collection->pluck('name');
$plucked->all();
// ['Desk', 'Chair']

你还可以指定如何希望结果集合被键设置：

$plucked = $collection->pluck('name', 'product_id');
$plucked->all();
// ['prod-100' => 'Desk', 'prod-200' => 'Chair']

pluck 方法也支持使用“点”表示法检索嵌套值：

$collection = collect([
        'name' => 'Laracon',
        'speakers' => [
            'first_day' => ['Rosa', 'Judith'],
        'name' => 'VueConf',
        'speakers' => [
            'first_day' => ['Abigail', 'Joey'],
$plucked = $collection->pluck('speakers.first_day');
$plucked->all();
// [['Rosa', 'Judith'], ['Abigail', 'Joey']]

如果存在重复键，则最后一个匹配元素将被插入到取出的集合中：

$collection = collect([
    ['brand' => 'Tesla',  'color' => 'red'],
    ['brand' => 'Pagani', 'color' => 'white'],
    ['brand' => 'Tesla',  'color' => 'black'],
    ['brand' => 'Pagani', 'color' => 'orange'],
$plucked = $collection->pluck('color', 'brand');
$plucked->all();
// ['Tesla' => 'black', 'Pagani' => 'orange']

pop() ​

pop 方法移除并返回集合中的最后一个项目：

$collection = collect([1, 2, 3, 4, 5]);
$collection->pop();
$collection->all();
// [1, 2, 3, 4]

你可以向 pop 方法传入一个整数来移除并返回集合末尾的多个项目：

$collection = collect([1, 2, 3, 4, 5]);
$collection->pop(3);
// collect([5, 4, 3])
$collection->all();
// [1, 2]

prepend() ​

prepend 方法将一个项目添加到集合的开头：

$collection = collect([1, 2, 3, 4, 5]);
$collection->prepend(0);
$collection->all();
// [0, 1, 2, 3, 4, 5]

你也可以传递第二个参数来指定要添加项目的键：

$collection = collect(['one' => 1, 'two' => 2]);
$collection->prepend(0, 'zero');
$collection->all();
// ['zero' => 0, 'one' => 1, 'two' => 2]

pull() ​

pull 方法通过其键移除并返回集合中的一个项目：

$collection = collect(['product_id' => 'prod-100', 'name' => 'Desk']);
$collection->pull('name');
// 'Desk'
$collection->all();
// ['product_id' => 'prod-100']

push() ​

push 方法将一个项目追加到集合的末尾：

$collection = collect([1, 2, 3, 4]);
$collection->push(5);
$collection->all();
// [1, 2, 3, 4, 5]

put() ​

put 方法在集合中设置给定的键和值：

$collection = collect(['product_id' => 1, 'name' => 'Desk']);
$collection->put('price', 100);
$collection->all();
// ['product_id' => 1, 'name' => 'Desk', 'price' => 100]

random() ​

random 方法从集合中返回一个随机项目：

$collection = collect([1, 2, 3, 4, 5]);
$collection->random();
// 4 - (随机获取)

你可以传递一个整数给 random 来指定你希望随机获取多少个项目。当明确传递希望接收的项目数量时，始终返回一个项目的集合：

$random = $collection->random(3);
$random->all();
// [2, 4, 5] - (随机获取)

如果集合实例中的项目少于请求的数量， random 方法将抛出一个 InvalidArgumentException 异常。

random 方法也接受一个闭包，该闭包将接收当前集合实例：

use Illuminate\Support\Collection;
$random = $collection->random(fn (Collection $items) => min(10, count($items)));
$random->all();
// [1, 2, 3, 4, 5] - (随机获取)

range() ​

range 方法返回一个包含指定范围内整数的集合：

$collection = collect()->range(3, 6);
$collection->all();
// [3, 4, 5, 6]

reduce() ​

reduce 方法将集合简化为单个值，将每次迭代的结果传递到后续迭代：

$collection = collect([1, 2, 3]);
$total = $collection->reduce(function (?int $carry, int $item) {
    return $carry + $item;
// 6

第一次迭代时 $carry 的值为 null ；但是，你可以通过向 reduce 传递第二个参数来指定其初始值：

$collection->reduce(function (int $carry, int $item) {
    return $carry + $item;
}, 4);
// 10

reduce 方法还会将关联集合中的数组键传递给给定的回调函数：

$collection = collect([
    'usd' => 1400,
    'gbp' => 1200,
    'eur' => 1000,
$ratio = [
    'usd' => 1,
    'gbp' => 1.37,
    'eur' => 1.22,
$collection->reduce(function (int $carry, int $value, int $key) use ($ratio) {
    return $carry + ($value * $ratio[$key]);
// 4264

reduceSpread() ​

reduceSpread 方法将集合简化为值数组，将每次迭代的结果传递到后续迭代。这个方法与 reduce 方法相似，但它可以接受多个初始值：

[$creditsRemaining, $batch] = Image::where('status', 'unprocessed')
    ->get()
    ->reduceSpread(function (int $creditsRemaining, Collection $batch, Image $image) {
        if ($creditsRemaining >= $image->creditsRequired()) {
            $batch->push($image);
            $creditsRemaining -= $image->creditsRequired();
        return [$creditsRemaining, $batch];
    }, $creditsAvailable, collect());

reject() ​

reject 方法使用给定的闭包对集合进行筛选。如果应该从结果集合中移除项，则闭包应该返回 true ：

$collection = collect([1, 2, 3, 4]);
$filtered = $collection->reject(function (int $value, int $key) {
    return $value > 2;
$filtered->all();
// [1, 2]

reject 方法的逆过程，请参见 filter 方法。

replace() ​

replace 方法的行为类似于 merge ；但是，除了覆盖具有字符串键的匹配项之外， replace 方法还将覆盖具有匹配数字键的集合中的项：

$collection = collect(['Taylor', 'Abigail', 'James']);
$replaced = $collection->replace([1 => 'Victoria', 3 => 'Finn']);
$replaced->all();
// ['Taylor', 'Victoria', 'James', 'Finn']

replaceRecursive() ​

这个方法的工作原理类似于 replace ，但它将递归到数组中，并将相同的替换过程应用于内部值：

$collection = collect([
    'Taylor',
    'Abigail',
        'James',
        'Victoria',
        'Finn'
$replaced = $collection->replaceRecursive([
    'Charlie',
    2 => [1 => 'King']
$replaced->all();
// ['Charlie', 'Abigail', ['James', 'King', 'Finn']]

reverse() ​

reverse 方法将集合中的项的顺序颠倒，保持原来的键：

$collection = collect(['a', 'b', 'c', 'd', 'e']);
$reversed = $collection->reverse();
$reversed->all();
        4 => 'e',
        3 => 'd',
        2 => 'c',
        1 => 'b',
        0 => 'a',
*/

search() ​

search 方法在集合中搜索给定值，并在找到时返回其键。如果未找到项，则返回 false ：

$collection = collect([2, 4, 6, 8]);
$collection->search(4);
// 1

搜索使用 "宽松" 比较，这意味着一个具有整数值的字符串将被认为等于同一值的整数。要使用 "严格" 比较，将 true 作为方法的第二个参数传递：

collect([2, 4, 6, 8])->search('4', $strict = true);
// false

或者，你可以提供自己的闭包来搜索第一个通过给定真理测试的项：

collect([2, 4, 6, 8])->search(function (int $item, int $key) {
    return $item > 5;
// 2

select() ​

select 方法从集合中选择给定键，类似于 SQL 的 SELECT 语句：

$users = collect([
    ['name' => 'Taylor Otwell', 'role' => 'Developer', 'status' => 'active'],
    ['name' => 'Victoria Faith', 'role' => 'Researcher', 'status' => 'active'],
$users->select(['name', 'role']);
        ['name' => 'Taylor Otwell', 'role' => 'Developer'],
        ['name' => 'Victoria Faith', 'role' => 'Researcher'],
*/

shift() ​

shift 方法移除并返回集合中的第一项：

$collection = collect([1, 2, 3, 4, 5]);
$collection->shift();
$collection->all();
// [2, 3, 4, 5]

你可以向 shift 方法传递一个整数来移除并返回集合头部的多个项目：

$collection = collect([1, 2, 3, 4, 5]);
$collection->shift(3);
// collect([1, 2, 3])
$collection->all();
// [4, 5]

shuffle() ​

shuffle 方法随机地打乱集合中的项：

$collection = collect([1, 2, 3, 4, 5]);
$shuffled = $collection->shuffle();
$shuffled->all();
// [3, 2, 5, 1, 4] - (随机生成)

skip() ​

skip 方法返回一个新的集合，从集合开始移除给定数量的元素：

$collection = collect([1, 2, 3, 4, 5, 6, 7, 8, 9, 10]);
$collection = $collection->skip(4);
$collection->all();
// [5, 6, 7, 8, 9, 10]

skipUntil() ​

skipUntil 方法从集合中跳过项，直到给定的回调函数返回 true ，然后将剩余的项作为一个新集合的实例返回：

$collection = collect([1, 2, 3, 4]);
$subset = $collection->skipUntil(function (int $item) {
    return $item >= 3;
$subset->all();
// [3, 4]

你还可以向 skipUntil 方法传递一个简单的值来跳过所有项，直到找到给定值：

$collection = collect([1, 2, 3, 4]);
$subset = $collection->skipUntil(3);
$subset->all();
// [3, 4]

skipWhile() ​

skipWhile 方法在给定的回调函数返回 true 时跳过来自集合的项，然后将剩余的项作为一个新集合返回：

$collection = collect([1, 2, 3, 4]);
$subset = $collection->skipWhile(function (int $item) {
    return $item <= 3;
$subset->all();
// [4]

slice() ​

slice 方法返回从给定索引开始的集合切片：

$collection = collect([1, 2, 3, 4, 5, 6, 7, 8, 9, 10]);
$slice = $collection->slice(4);
$slice->all();
// [5, 6, 7, 8, 9, 10]

如果你想要限制返回的切片的大小，请将希望的大小作为第二个参数传递给方法：

$slice = $collection->slice(4, 2);
$slice->all();
// [5, 6]

返回的切片默认会保持键。如果你不希望保留原始键，你可以使用 values 方法重新索引它们。

sliding() ​

sliding 方法返回一个新的集合，其中包含代表集合中项目的“滑动窗口”视图的块：

$collection = collect([1, 2, 3, 4, 5]);
$chunks = $collection->sliding(2);
$chunks->toArray();
// [[1, 2], [2, 3], [3, 4], [4, 5]]

这在搭配 eachSpread 方法使用时特别有用：

$transactions->sliding(2)->eachSpread(function (Collection $previous, Collection $current) {
    $current->total = $previous->total + $current->amount;
});

你可以选择传递第二个“步长”值，这决定了每个块的第一个项目之间的距离：

$collection = collect([1, 2, 3, 4, 5]);
$chunks = $collection->sliding(3, step: 2);
$chunks->toArray();
// [[1, 2, 3], [3, 4, 5]]

sole() ​

sole 方法返回集合中通过给定真理测试的第一个元素，但前提是真理测试只与一个元素相匹配：

collect([1, 2, 3, 4])->sole(function (int $value, int $key) {
    return $value === 2;
// 2

你也可以传递一个键/值对给 sole 方法，它将返回集合中与给定对匹配的第一个元素，但前提是只有一个元素与之匹配：

$collection = collect([
    ['product' => 'Desk', 'price' => 200],
    ['product' => 'Chair', 'price' => 100],
$collection->sole('product', 'Chair');
// ['product' => 'Chair', 'price' => 100]

或者，你也可以不带参数调用 sole 方法来获取集合中的第一个元素，如果集合中只有一个元素：

$collection = collect([
    ['product' => 'Desk', 'price' => 200],
$collection->sole();
// ['product' => 'Desk', 'price' => 200]

如果集合中没有元素应该由 sole 方法返回，将抛出一个 \Illuminate\Collections\ItemNotFoundException 异常。如果有多个元素应该返回，将抛出一个 \Illuminate\Collections\MultipleItemsFoundException 异常。

some() ​

contains 方法的别名。

sort() ​

sort 方法对集合进行排序。排序后的集合保持原始数组键，所以在以下示例中我们将使用 values 方法来重置键，使之成为连续编号的索引：

$collection = collect([5, 3, 1, 2, 4]);
$sorted = $collection->sort();
$sorted->values()->all();
// [1, 2, 3, 4, 5]

如果你的排序需求更高级，你可以传递一个具有自己算法的回调函数给 sort 。参考 PHP 的 uasort 文档，这正是集合的 sort 方法内部调用的方法。

sortBy() ​

sortBy 方法按给定键对集合进行排序。排序后的集合保持原始数组键，所以在以下示例中我们将使用 values 方法来重置键，使之成为连续编号的索引：

$collection = collect([
    ['name' => 'Desk', 'price' => 200],
    ['name' => 'Chair', 'price' => 100],
    ['name' => 'Bookcase', 'price' => 150],
$sorted = $collection->sortBy('price');
$sorted->values()->all();
        ['name' => 'Chair', 'price' => 100],
        ['name' => 'Bookcase', 'price' => 150],
        ['name' => 'Desk', 'price' => 200],
*/

sortBy 方法可以接受 排序标志 作为其第二个参数：

$collection = collect([
    ['title' => 'Item 1'],
    ['title' => 'Item 12'],
    ['title' => 'Item 3'],
$sorted = $collection->sortBy('title', SORT_NATURAL);
$sorted->values()->all();
        ['title' => 'Item 1'],
        ['title' => 'Item 3'],
        ['title' => 'Item 12'],
*/

或者，你可以传递你自己的闭包来确定怎么对集合的值进行排序：

$collection = collect([
    ['name' => 'Desk', 'colors' => ['Black', 'Mahogany']],
    ['name' => 'Chair', 'colors' => ['Black']],
    ['name' => 'Bookcase', 'colors' => ['Red', 'Beige', 'Brown']],
$sorted = $collection->sortBy(function (array $product, int $key) {
    return count($product['colors']);
$sorted->values()->all();
        ['name' => 'Chair', 'colors' => ['Black']],
        ['name' => 'Desk', 'colors' => ['Black', 'Mahogany']],
        ['name' =>

range() ​

range 方法返回一个包含指定范围内整数的集合：

$collection = collect()->range(3, 6);
$collection->all();
// [3, 4, 5, 6]

reduce() ​

reduce 方法将集合简化为单个值，将每次迭代的结果传递到后续迭代：

$collection = collect([1, 2, 3]);
$total = $collection->reduce(function (?int $carry, int $item) {
    return $carry + $item;
// 6

第一次迭代时 $carry 的值为 null ；但是，你可以通过向 reduce 传递第二个参数来指定其初始值：

$collection->reduce(function (int $carry, int $item) {
    return $carry + $item;
}, 4);
// 10

reduce 方法还会将关联集合中的数组键传递给给定的回调函数：

$collection = collect([
    'usd' => 1400,
    'gbp' => 1200,
    'eur' => 1000,
$ratio = [
    'usd' => 1,
    'gbp' => 1.37,
    'eur' => 1.22,
$collection->reduce(function (int $carry, int $value, int $key) use ($ratio) {
    return $carry + ($value * $ratio[$key]);
// 4264

reduceSpread() ​

reduceSpread 方法将集合简化为值数组，将每次迭代的结果传递到后续迭代。这个方法与 reduce 方法相似，但它可以接受多个初始值：

[$creditsRemaining, $batch] = Image::where('status', 'unprocessed')
    ->get()
    ->reduceSpread(function (int $creditsRemaining, Collection $batch, Image $image) {
        if ($creditsRemaining >= $image->creditsRequired()) {
            $batch->push($image);
            $creditsRemaining -= $image->creditsRequired();
        return [$creditsRemaining, $batch];
    }, $creditsAvailable, collect());

reject() ​

reject 方法使用给定的闭包对集合进行筛选。如果应该从结果集合中移除项，则闭包应该返回 true ：

$collection = collect([1, 2, 3, 4]);
$filtered = $collection->reject(function (int $value, int $key) {
    return $value > 2;
$filtered->all();
// [1, 2]

reject 方法的逆过程，请参见 filter 方法。

replace() ​

replace 方法的行为类似于 merge ；但是，除了覆盖具有字符串键的匹配项之外， replace 方法还将覆盖具有匹配数字键的集合中的项：

$collection = collect(['Taylor', 'Abigail', 'James']);
$replaced = $collection->replace([1 => 'Victoria', 3 => 'Finn']);
$replaced->all();
// ['Taylor', 'Victoria', 'James', 'Finn']

replaceRecursive() ​

这个方法的工作原理类似于 replace ，但它将递归到数组中，并将相同的替换过程应用于内部值：

$collection = collect([
    'Taylor',
    'Abigail',
        'James',
        'Victoria',
        'Finn'
$replaced = $collection->replaceRecursive([
    'Charlie',
    2 => [1 => 'King']
$replaced->all();
// ['Charlie', 'Abigail', ['James', 'King', 'Finn']]

reverse() ​

reverse 方法将集合中的项的顺序颠倒，保持原来的键：

$collection = collect(['a', 'b', 'c', 'd', 'e']);
$reversed = $collection->reverse();
$reversed->all();
        4 => 'e',
        3 => 'd',
        2 => 'c',
        1 => 'b',
        0 => 'a',
*/

search() ​

search 方法在集合中搜索给定值，并在找到时返回其键。如果未找到项，则返回 false ：

$collection = collect([2, 4, 6, 8]);
$collection->search(4);
// 1

搜索使用 "宽松" 比较，这意味着一个具有整数值的字符串将被认为等于同一值的整数。要使用 "严格" 比较，将 true 作为方法的第二个参数传递：

collect([2, 4, 6, 8])->search('4', $strict = true);
// false

或者，你可以提供自己的闭包来搜索第一个通过给定真理测试的项：

collect([2, 4, 6, 8])->search(function (int $item, int $key) {
    return $item > 5;
// 2

select() ​

select 方法从集合中选择给定键，类似于 SQL 的 SELECT 语句：

$users = collect([
    ['name' => 'Taylor Otwell', 'role' => 'Developer', 'status' => 'active'],
    ['name' => 'Victoria Faith', 'role' => 'Researcher', 'status' => 'active'],
$users->select(['name', 'role']);
        ['name' => 'Taylor Otwell', 'role' => 'Developer'],
        ['name' => 'Victoria Faith', 'role' => 'Researcher'],
*/

shift() ​

shift 方法移除并返回集合中的第一项：

$collection = collect([1, 2, 3, 4, 5]);
$collection->shift();
$collection->all();
// [2, 3, 4, 5]

你可以向 shift 方法传递一个整数来移除并返回集合头部的多个项目：

$collection = collect([1, 2, 3, 4, 5]);
$collection->shift(3);
// collect([1, 2, 3])
$collection->all();
// [4, 5]

shuffle() ​

shuffle 方法随机地打乱集合中的项：

$collection = collect([1, 2, 3, 4, 5]);
$shuffled = $collection->shuffle();
$shuffled->all();
// [3, 2, 5, 1, 4] - (随机生成)

skip() ​

skip 方法返回一个新的集合，从集合开始移除给定数量的元素：

$collection = collect([1, 2, 3, 4, 5, 6, 7, 8, 9, 10]);
$collection = $collection->skip(4);
$collection->all();
// [5, 6, 7, 8, 9, 10]

skipUntil() ​

skipUntil 方法从集合中跳过项，直到给定的回调函数返回 true ，然后将剩余的项作为一个新集合的实例返回：

$collection = collect([1, 2, 3, 4]);
$subset = $collection->skipUntil(function (int $item) {
    return $item >= 3;
$subset->all();
// [3, 4]

你还可以向 skipUntil 方法传递一个简单的值来跳过所有项，直到找到给定值：

$collection = collect([1, 2, 3, 4]);
$subset = $collection->skipUntil(3);
$subset->all();
// [3, 4]

skipWhile() ​

skipWhile 方法在给定的回调函数返回 true 时跳过来自集合的项，然后将剩余的项作为一个新集合返回：

$collection = collect([1, 2, 3, 4]);
$subset = $collection->skipWhile(function (int $item) {
    return $item <= 3;
$subset->all();
// [4]

slice() ​

slice 方法返回从给定索引开始的集合切片：

$collection = collect([1, 2, 3, 4, 5, 6, 7, 8, 9, 10]);
$slice = $collection->slice(4);
$slice->all();
// [5, 6, 7, 8, 9, 10]

如果你想要限制返回的切片的大小，请将希望的大小作为第二个参数传递给方法：

$slice = $collection->slice(4, 2);
$slice->all();
// [5, 6]

返回的切片默认会保持键。如果你不希望保留原始键，你可以使用 values 方法重新索引它们。

sliding() ​

sliding 方法返回一个新的集合，其中包含代表集合中项目的“滑动窗口”视图的块：

$collection = collect([1, 2, 3, 4, 5]);
$chunks = $collection->sliding(2);
$chunks->toArray();
// [[1, 2], [2, 3], [3, 4], [4, 5]]

这在搭配 eachSpread 方法使用时特别有用：

$transactions->sliding(2)->eachSpread(function (Collection $previous, Collection $current) {
    $current->total = $previous->total + $current->amount;
});