Laravel Collection reject() 索引保留解析

Laravel Collection 的 `reject()` 方法在移除元素后，会保留原始数组的键名，导致返回一个带有非连续索引的关联数组。这一行为源于其底层依赖 PHP 的 `array_filter()` 函数，该函数在过滤元素时会保留键名。理解这一机制并掌握使用 `values()` 方法重置索引是高效处理集合的关键。

深入理解 Laravel Collection reject() 的键名保留行为

在使用 Laravel Collection 时，开发者可能会遇到一个常见的行为：当使用 reject() 或 filter() 等方法移除集合中的元素后，返回的集合或数组会保留原始的键名，从而导致数值索引出现不连续的“空洞”。本教程将详细解析这一现象背后的原理，并提供有效的解决方案。

1. array_filter() 的核心作用

这一行为的根本原因在于 Laravel Collection 的 reject() 和 filter() 方法在底层使用了 PHP 的内置函数 array_filter()。array_filter() 函数的设计初衷是遍历数组中的每个值，并根据回调函数的返回结果来决定是否保留该值。关键在于，array_filter() 在过滤元素时会保留原始数组的键名。

array_filter() 行为示例：

 10, 1 => 20, 2 => 30, 3 => 40];
$filteredData = array_filter($data, function($value) {
    return $value !== 20; // 移除值为20的元素
});

print_r($filteredData);
/*
输出:
Array
(
    [0] => 10
    [2] => 30
    [3] => 40
)
*/
?>

从上述示例可以看出，当值为 20 的元素（其键为 1）被移除后，剩余元素的键 0、2、3 依然被保留，导致索引不再是连续的 0, 1, 2。

2. Laravel Collection filter() 方法的实现

Collection::reject() 方法实际上是 Collection::filter() 方法的一个变体，它通过反转回调函数的逻辑来实现“拒绝”功能。因此，理解 filter() 的实现对于理解 reject() 的行为至关重要。

以下是 Laravel Collection 中 filter() 方法的关键代码片段：

/**
 * Run a filter over each of the items.
 *
 * @param  callable|null  $callback
 * @return static
 */
public function filter(callable $callback = null)
{
    if ($callback) {
        // 如果提供了回调函数，则使用 Arr::where
        return new static(Arr::where($this->items, $callback));
    }

    // 如果没有提供回调函数，则直接使用 array_filter
    return new static(array_filter($this->items));
}

这段代码清晰地表明，filter() 方法要么直接调用 array_filter()，要么通过 Arr::where 辅助函数进行过滤。而 Arr::where 本身也是 array_filter() 的一个封装，旨在提供更便捷的用法并确保一致的键名保留行为。因此，reject() 方法自然也继承了这种键名保留的特性。

3. reject() 方法的实际演示

让我们回顾最初的问题示例：

>>> collect([1, 2, 'X', 4])->reject('X')->all();
=> [
     0 => 1,
     1 => 2,
     3 => 4, // 注意：键 '2' 被跳过，因为 'X' 被拒绝
   ]

在这个例子中，位于键 2 的元素 'X' 被 reject() 方法移除。结果是，返回的数组保留了原始的键 0、1 和 3，而键 2 则被跳过。这使得最终的输出是一个关联数组，而非一个从 0 开始的严格连续索引数组。

4. 解决键名空洞：使用 values() 方法

如果您的应用逻辑需要一个从 0 开始的连续数值索引数组（例如，为了 JSON 序列化时保持数组格式，或在迭代时依赖连续索引），Laravel Collection 提供了 values() 方法来解决这个问题。values() 方法会丢弃集合中原有的键名，并重新分配从 0 开始的连续整数键。

使用 values() 方法的示例：

>>> collect([1, 2, 'X', 4])->reject('X')->values()->all();
=> [
     0 => 1,
     1 => 2,
     2 => 4,
   ]

通过在 reject() 之后链式调用 ->values()，集合被重新索引，从而得到一个干净、无间隙的数值索引数组。在纯 PHP 中，实现相同效果的函数是 array_values()。

5. 注意事项与总结

• 理解默认行为：reject() 和 filter() 方法（以及 PHP 的 array_filter()）默认会保留原始键名。这种行为在需要维护元素与其原始位置或标识符关联时非常有用。
• 何时重新索引：当您的应用需要一个紧凑、从 0 开始的数值索引数组时（例如，在前端处理数据或进行某些特定算法时），请务必在 reject() 或 filter() 之后链式调用 ->values()。
• 性能考量：values() 方法会创建一个新的数组并重新分配键名，这会带来微小的性能开销。对于极大的集合，请权衡是否确实需要重新索引，或者是否可以接受处理关联数组。

掌握 reject() 和 filter() 的键名保留机制，以及如何使用 values() 方法来管理索引，是高效使用 Laravel Collection 的关键技能。这将帮助您编写更健壮、更符合预期的代码。