PHP SplFixedArray.fromArray 怎样保留或重排原数组索引

SplFixedArray::fromArray() 是否保留原数组索引，只看第二个参数 $preserveKeys。默认值是 true：它会尝试保存原数组中的数字索引，稀疏索引之间会留下空位；传入 false：元素按原数组的遍历顺序重新编号为连续索引。

官方文档：

官方地址：https://www.php.net/manual/en/splfixedarray.fromarray.php

需要保留“位置含义”时用 true，需要把数据压成连续列表时用 false。两种结果都返回新的 SplFixedArray，后续长度调整仍要显式调用 setSize()。

两个参数分支先看结果

下面的输入故意使用 1、0、3 三个不连续的数字索引。它同时展示了“数字索引”和“输入顺序”是两套不同的信息：数组的遍历顺序仍是 1、0、3，但保留索引时，容器要按位置 0 到 3 安排槽位。

 'one',
    0 => 'zero',
    3 => 'three',
];

// 默认 preserveKeys=true：尽量保留原数字索引。
$keepKeys = SplFixedArray::fromArray($source);

// false：不保留原索引，而是沿用 foreach 的输入顺序重新编号。
$reindex = SplFixedArray::fromArray($source, false);

// 用 toArray() 便于观察导入后的槽位；业务代码中也可直接按整数索引读取。
var_dump($keepKeys->toArray());
var_dump($reindex->toArray());
?>

这个例子中，$keepKeys 的有效位置是 0、1、3，位置 2 没有来源值，因此会看到一个 null 槽位；$reindex 则得到索引 0、1、2，对应值的顺序是 one、zero、three。

用 preserveKeys=true 保留位置

保留索引适合“索引本身就是业务位置”的数据，例如把编号映射到槽位、把文件列号映射到字段或把稀疏数据送入固定长度的后续处理。它的代价是容器长度要覆盖需要的数字位置，未赋值的位置可能保留为 null。

 'one', 0 => 'zero', 3 => 'three'];
$slots = SplFixedArray::fromArray($source, true);

// 先判断位置是否存在，再读取，避免把“空槽位”误当成业务值。
for ($index = 0; $index getSize(); $index++) {
    $value = $slots[$index];
    echo $index, ': ', $value === null ? '(empty)' : $value, PHP_EOL;
}
?>

这里的 null 不代表 fromArray() 把某个值改成了空值，而是位置 2 在源数组里没有对应元素。若业务上“空槽位”和“真实的 null 值”需要区分，就不能只依赖读取结果，还要另外保存占位信息或输入键集合。

用 preserveKeys=false 压紧数据

如果输入数组的键只是历史遗留、分页游标或过滤前的编号，而后续算法只关心元素顺序，那么 false 更直接。它不按最大数字索引扩展容器，而是把每个元素依次放进 0、1、2……。

 'apple', 9 => 'banana', 12 => 'orange'];
$queue = SplFixedArray::fromArray($filtered, false);

// 连续索引便于按位置处理，输入值的 foreach 顺序仍然保留下来。
foreach ($queue as $index => $value) {
    echo $index, ': ', $value, PHP_EOL;
}
?>

注意，“重排索引”不等于排序。fromArray($filtered, false) 不会按键值或元素内容排序，它只是按照源数组当前的迭代顺序重新编号。若需要排序，应在导入前明确排序，或在导入后使用适合 SplFixedArray 的处理方式。

把导入结果接入固定数组工作流

SplFixedArray 允许整数索引访问，并且长度不是随着任意写入自动扩展的普通 PHP 数组。导入时会得到一份新的固定数组；如果后续工作确实需要更多槽位，要明确调用 setSize()，而不是假设写入越界会自动增长。

setSize(5);
$items[3] = 'grape';

// 对外返回普通数组，避免把固定数组对象泄露给只接受 array 的调用方。
$result = $items->toArray();
var_dump($result);
?>

缩小长度也要谨慎：超出新长度的元素会被截掉。把 setSize() 当成工作流中的明确阶段，可以让容量变化有记录，也能避免把一次索引策略选择误认为自动扩容策略。

失败处理和索引边界

这类代码最常见的错误不是参数拼写，而是把三种含义混在一起：源数组的数字键、源数组的遍历顺序，以及目标容器的固定长度。可以用下面的决策表在导入前先确定语义。

读写索引时还要考虑范围。官方文档说明，越界访问会抛出异常；PHP 8.1 起对非整数键的行为也更严格。生产代码可以把外部输入先转换并检查为整数，再决定是拒绝、记录还是调整容器，而不要让错误索引静默流入业务。

常见问题

为什么默认结果里会出现 null？

因为默认的 preserveKeys 是 true。如果源数组的数字索引不连续，固定数组需要保留这些位置，未提供值的位置就会成为空槽位。

传 false 会不会改变元素顺序？

它不会主动排序，而是按照源数组当前的迭代顺序，把元素依次放到连续索引中。若源数组已经有特定插入顺序，这个顺序会被保留。

SplFixedArray 能像普通数组一样自动变长吗？

不要这样假设。需要改变长度时调用 setSize()，并在缩小时确认被截断的元素是否可以丢弃。

什么时候应该直接保留普通 PHP 数组？

如果代码依赖大量数组函数、频繁变更键或不需要固定长度语义，普通数组可能更简单。SplFixedArray 的价值在于固定槽位和整数索引，不能只因为“看起来更专业”就替换全部数组。

小结

SplFixedArray::fromArray() 的选择可以归纳为一句话：要位置就保留键，要连续列表就重排键。使用 true 时提前处理空槽位，使用 false 时记住它只重编号不排序；导入后把 setSize()、越界处理和 toArray() 当成明确的流水线步骤，索引语义就不会在后续处理中丢失。