PHP数组操作冗长低效？seboettg/collection助你优雅处理复杂数据！

可以通过一下地址学习composer：学习地址

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 的关联数组，但提供了更面向对象的操作方法，并且确保键的唯一性。

BGremover

VanceAI推出的图片背景移除工具

下载

创建映射：

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 代码焕发新的活力。告别繁琐，拥抱优雅，从现在开始！