PHP 数组的“痛点”：当灵活性遇到复杂度
我最近在开发一个电商后台系统时，遇到了一个典型的问题：需要从用户订单列表中筛选出特定状态的订单，然后对这些订单中的商品进行汇总，最后再按商品类别进行分组。如果使用php原生的数组函数，比如array_filter、array_map、array_reduce，虽然也能实现，但代码会变得非常零散，逻辑跳跃，而且难以一眼看出数据的流向。更糟糕的是，如果我需要对一个由自定义对象组成的数组进行操作，原生的数组函数通常只能处理基本类型或关联数组，对于对象的属性操作则需要额外的循环和判断，这让代码显得格外笨重。
传统的PHP数组操作，虽然强大，但缺乏面向对象的封装和一些高级语言中常见的函数式编程特性。我们常常需要手动编写循环，管理索引，这不仅增加了代码量，也使得代码的意图不够清晰。我常常想，如果PHP也能像Java或Kotlin那样，拥有一个统一、功能丰富的集合框架，那该多好！
救星登场：seboettg/collection
就在我为这些繁琐的数组操作感到困扰时，我发现了 seboettg/collection 这个宝藏库。它就像是为PHP数组量身定制的一套“高级工具箱”，提供了一系列实用的封装类，让数组操作变得更加优雅和高效。它借鉴了其他语言中成熟的集合框架设计理念，将常见的列表（List）、映射（Map）、栈（Stack）和队列（Queue）等数据结构以面向对象的方式呈现，并支持流畅的链式调用，极大提升了代码的可读性和开发效率。
通过 Composer 轻松安装：
seboettg/collection 的安装非常简单，只需通过 Composer 运行以下命令：
立即学习“PHP免费学习笔记（深入）”；
composer require seboettg/collection
安装完成后，记得在你的项目中引入 Composer 的自动加载文件：
require 'vendor/autoload.php';
现在，你就可以开始享受它带来的便利了！
核心功能一览：让数据操作更丝滑
seboettg/collection 提供了 List、Map、Stack 和 Queue 四种核心数据结构，每种都封装了丰富的操作方法。
1. List（列表）：有序集合的强大工具
List 是最常用的数据结构之一，它允许我们像处理有序数组一样操作数据，但提供了更丰富的函数式方法。
创建列表：
你可以从零开始创建，也可以从现有数组转换。
use function Seboettg\Collection\Lists\listOf;
use function Seboettg\Collection\Lists\listFromArray;
use function Seboettg\Collection\Lists\emptyList;
// 创建一个简单列表
$list = listOf("a", "b", "c", "d");
print_r($list);
// 从现有数组创建列表
$array = ["d", "e", "f"];
$otherList = listFromArray($array);
// 创建一个空列表
$emptyList = emptyList();
echo $emptyList->count(); // 输出：0函数式操作：map 和 filter
这是我最喜欢的功能之一。map 可以将列表中的每个元素进行转换，生成一个新的列表；filter 则根据条件筛选元素。
$numbers = listOf(1, 2, 3, 4, 5); // 将每个数字立方 $cubicNumbers = $numbers->map(fn ($i) => $i * $i * $i); // 结果：[1, 8, 27, 64, 125] // 筛选出奇数 $oddNumbers = $numbers->filter(fn($number) => $number % 2 !== 0); // 结果：[1, 3, 5]
这种链式调用让代码逻辑清晰，一目了然。
其他常用操作：
-
plus($otherList)/minus($otherList): 列表合并或减去另一个列表的元素。 -
intersect($otherList): 获取两个列表的交集。 -
distinct(): 获取列表中不重复的元素。 -
forEach(callable $callback): 对每个元素执行一个回调函数。 -
all(callable $predicate)/any(callable $predicate): 判断所有元素或至少一个元素是否满足条件。 -
排序: 支持通过实现
Comparable接口或自定义Comparator类进行复杂对象的排序。
2. Map（映射）：键值对的便捷管理
Map 类似于 PHP 的关联数组，但提供了更面向对象的操作方法，并且确保键的唯一性。
创建映射：
use Seboettg\Collection\Map\Pair;
use function Seboettg\Collection\Map\pair;
use function Seboettg\Collection\Map\mapOf;
use function Seboettg\Collection\Map\emptyMap;
// 通过 Pair 对象创建映射
$map = mapOf(
pair("Ceres", "Giuseppe Piazzi"),
pair("Pallas", "Heinrich Wilhelm Olbers")
);
print_r($map);
// 创建空映射
$emptyMap = emptyMap();
echo $emptyMap->count(); // 输出：0访问和操作元素：
$asteroidExplorerMap = mapOf(
pair("Ceres", "Giuseppe Piazzi"),
pair("Pallas", "Heinrich Wilhelm Olbers"),
pair("Juno", "Karl Ludwig Harding"),
pair("Vesta", "Heinrich Wilhelm Olbers")
);
echo $asteroidExplorerMap->get("Juno"); // 输出：Karl Ludwig Harding
echo $asteroidExplorerMap["Pallas"]; // 也可以像数组一样访问
$keys = $asteroidExplorerMap->getKeys(); // 获取所有键的列表
$values = $asteroidExplorerMap->values()->distinct(); // 获取所有不重复的值的列表
$asteroidExplorerMap->put("Iris", "J. R. Hind"); // 添加或更新元素
$asteroidExplorerMap->remove("Juno"); // 移除元素映射和过滤：
Map 同样支持 map 和 filter 方法，可以方便地将键值对转换为其他对象或根据条件筛选条目。
class Asteroid {
public string $name;
public ?string $explorer;
public function __construct(string $name, string $explorer) {
$this->name = $name;
$this->explorer = $explorer;
}
}
// 将映射中的键值对转换为 Asteroid 对象列表
$asteroids = $asteroidExplorerMap
->map(fn (string $key, string $value): Asteroid => new Asteroid($key, $value));
// 过滤掉键为 "Juno" 的条目
$filteredMap = $asteroidExplorerMap->filter(fn (string $key, string $value): bool => $key !== "Juno");3. Stack（栈）和 Queue（队列）：标准数据结构的实现
seboettg/collection 还提供了标准的栈（LIFO，后进先出）和队列（FIFO，先进先出）数据结构，方便你在需要这些特定行为的场景下使用。
Stack 示例：
use Seboettg\Collection\Stack;
$stack = new Stack();
$stack->push("a")->push("b")->push("c");
echo $stack->pop(); // 输出 c
echo $stack->count(); // 输出 2
echo $stack->peek(); // 输出 b (不移除)Queue 示例：
use Seboettg\Collection\Queue;
$queue = new Queue();
$queue->enqueue("d")->enqueue("z")->enqueue("b");
echo $queue->dequeue(); // 输出 d
echo $queue->dequeue(); // 输出 z实战演练：List 与 Map 的强强联合
seboettg/collection 的真正威力在于 List 和 Map 之间的无缝协作。想象一下，我们有一个 customer.json 文件，里面包含客户信息，我们想将其解析为 Customer 对象，并以客户ID为键，方便快速查找。
customer.json 示例：
[
{
"id": "A001",
"lastname": "Doe",
"firstname": "John",
"createDate": "2022-06-10 09:21:12"
},
{
"id": "A002",
"lastname": "Doe",
"firstname": "Jane",
"createDate": "2022-06-10 09:21:13"
},
{
"id": "A004",
"lastname": "Mustermann",
"firstname": "Erika",
"createDate": "2022-06-11 08:21:13"
}
]处理逻辑：
use function Seboettg\Collection\Lists\listFromArray;
class Customer {
public string $id;
public string $lastname;
public string $firstname;
public DateTime $createDate;
public function __construct(string $id, string $lastname, string $firstname, DateTime $createDate) {
$this->id = $id;
$this->lastname = $lastname;
$this->firstname = $firstname;
$this->createDate = $createDate;
}
}
// 1. 从 JSON 文件加载数据并转换为 List
$customerList = listFromArray(json_decode(file_get_contents("customer.json"), true));
// 2. 链式操作：筛选、映射和关联
$customerMap = $customerList
->filter(fn (array $customerArray) => $customerArray["lastname"] === "Doe") // 筛选出姓氏为 "Doe" 的客户
->map(fn (array $customerArray) => new Customer( // 将数组映射为 Customer 对象
$customerArray["id"],
$customerArray["lastname"],
$customerArray["firstname"],
DateTime::createFromFormat("Y-m-d H:i:s", $customerArray["createDate"])
))
->associateBy(fn(Customer $customer) => $customer->id); // 以客户ID作为键，将 Customer 对象关联起来
print_r($customerMap);输出结果：
Seboettg\Collection\Map\MapInterface@anonymous Object
(
[array:Seboettg\Collection\Map\MapInterface@anonymous:private] => Array
(
[A001] => Customer Object (...) // John Doe
[A002] => Customer Object (...) // Jane Doe
)
)通过这几行简洁的代码，我们就完成了数据加载、筛选、对象转换和按键关联的复杂任务。对比传统方式，这大大减少了样板代码，提高了可读性和维护性。
另一个例子是根据一系列ID批量获取客户：
// 假设 $customerService 是一个服务，提供 getById 方法
$listOfIds = listOf("A001", "A002", "A004");
$customerMap = $listOfIds
->associateWith(fn ($customerId) => $customerService->getById($customerId)); // 根据每个ID获取客户对象并关联这比手动循环并构建一个关联数组要优雅得多。
总结：告别繁琐，拥抱优雅
seboettg/collection 库的引入，彻底改变了我处理 PHP 数组的方式。它将原本散乱、冗长的数组操作，封装成了富有表现力、易于理解的链式调用。这不仅让我的代码更加整洁、可读性更强，也极大地提升了开发效率，减少了因手动索引或循环带来的潜在错误。
如果你也曾为 PHP 数组的复杂操作而烦恼，那么我强烈推荐你尝试 seboettg/collection。它能帮助你将数据处理从“面向过程”的思维，提升到“面向对象”和“函数式”的更高层面，让你的 PHP 代码焕发新的活力。告别繁琐，拥抱优雅，从现在开始！
