Spatie PHP 包：方法、示例、安装

这是什么库以及为什么需要它

\n\n

Spatie 不仅仅是一个库，而是一个由同名比利时公司开发的高质量 PHP 包生态系统。Spatie 以其创建干净、可测试且文档完善的代码而闻名。它们的包涵盖了广泛的任务：从处理媒体文件和查询缓存到管理角色和权限。

\n\n

Spatie 集合工具集 (spatie/collection-utilities) 是一组辅助函数和类，用于扩展 PHP 中数组和集合的标准功能。它提供了方便的方法来进行数据过滤、排序、转换和分析，使代码更具可读性和简洁性。

\n\n

为什么需要它？ 在现代 PHP 开发中（尤其是在像 Laravel 这样的框架中），处理数据集合是日常任务。Spatie Collection Utilities 免去了编写重复循环和条件的需要，提供了现成的、经过充分测试的解决方案。这加快了开发速度，减少了错误数量，并提高了代码的可维护性。

\n\n

安装

\n\n

Spatie 包的安装通过 Composer 进行，Composer 是 PHP 的标准依赖管理器。

\n\n

composer require spatie/collection-utilities

\n\n

如果您使用 Laravel，该包会通过 Composer 的自动加载自动注册。对于其他框架或纯 PHP，只需在您的脚本中添加 require 'vendor/autoload.php'; 即可。

\n\n

快速入门及代码示例

\n\n

安装后，您可以立即开始使用这些工具。您将使用的主要类是 Spatie\\CollectionUtilities\\Collection。它扩展了标准的 Illuminate\\Support\\Collection 类（来自 Laravel），或者可以作为一个独立的类使用。

\n\n

<?php\nrequire 'vendor/autoload.php';\n\nuse Spatie\\CollectionUtilities\\Collection;\n\n// 创建一个集合\n$collection = new Collection([1, 2, 3, 4, 5, 6, 7, 8, 9, 10]);\n\n// 使用 filter 方法获取偶数\n$evenNumbers = $collection->filter(fn($item) => $item % 2 === 0);\n\n// 使用 map 方法将每个元素乘以 2\n$doubled = $evenNumbers->map(fn($item) => $item * 2);\n\n// 使用 toArray 方法转换回数组\nprint_r($doubled->toArray());\n// 输出：Array ( [0] => 4 [1] => 8 [2] => 12 [3] => 16 [4] => 20 )\n?>

\n\n

这个简单的示例演示了方法链，这是使用 Spatie 集合的一个关键特性。

\n\n

主要方法/函数

\n\n

1. `filter()`

功能： 使用回调函数过滤集合。仅返回回调函数返回 true 的元素。

参数：

callback (callable): 接收当前元素及其键的函数。必须返回 true 或 false。
mode (int): 可选。过滤模式（默认为 ARRAY_FILTER_USE_BOTH）。

工作代码示例：

$users = new Collection([\n    ['name' => 'Alice', 'age' => 25],\n    ['name' => 'Bob', 'age' => 17],\n    ['name' => 'Charlie', 'age' => 30],\n]);\n\n$adults = $users->filter(fn($user) => $user['age'] >= 18);\n// 结果：包含 Alice 和 Charlie 的集合

\n\n