PHP SplFixedArray 怎样从普通数组转换并保留索引

如果手里的数据已经是普通 PHP 数组，但下一步需要固定长度、整数下标的容器，最直接的做法是调用 SplFixedArray::fromArray($array, true)。第二个参数 preserveKeys 默认就是 true，会尽量保留原数组里的数值索引；如果传入 false，元素会按读取顺序重新放入从 0 开始的连续位置。

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

需要“原索引对应原位置”时使用默认的 true；需要“只保留元素顺序并重新编号”时使用 false。稀疏索引会让保留后的 SplFixedArray 中间出现 null 槽位，这是位置被保留下来的结果。

先用默认参数完成转换

fromArray() 是静态方法，返回一个新的 SplFixedArray 对象，不会把原数组原地改成另一种类型。默认参数为 true，适合原数组已经用整数位置表达业务含义的场景。

 '待处理', 1 => '已完成', 2 => '已归档'];
$fixed = SplFixedArray::fromArray($source);

// 用 getSize() 观察固定容器的长度，用下标读取转换后的值。
echo $fixed->getSize(), PHP_EOL;
echo $fixed[1], PHP_EOL;
// 这里输出 3 和“已完成”。
?>

转换后的对象仍然只接受整数范围内的索引，长度由输入数组决定。要继续扩容或缩容，应显式调用 setSize()，不要把它当成可以自动增长的普通数组。

保留索引时，稀疏位置会留下空槽

保留索引的重点不是“把键名打印出来”，而是让数值键继续对应相同的位置。例如数组只有 1、4、7 三个位置，转换后容器需要能覆盖 0 到 7；没有值的位置会是 null。

 'A', 4 => 'B', 7 => 'C'];
$fixed = SplFixedArray::fromArray($source, true);

// 依次读取 0 到 7，未赋值的位置会得到 null。
for ($index = 0; $index getSize(); $index++) {
    // var_export 便于区分字符串和 null，避免把空槽误认为空字符串。
    echo $index, ': ';
    var_export($fixed[$index]);
    echo PHP_EOL;
}
?>

这类结果适合“索引就是业务位置”的数据，例如固定列号、网格坐标或预留槽位。它不适合被误解成键值映射：SplFixedArray 的有效索引是从 0 到长度减 1 的整数范围。

不需要原键时，用 false 连续重排

如果原数组的键只是历史遗留编号，而读者真正关心的是元素出现顺序，可以把第二个参数设为 false。这会按数组遍历顺序生成连续的 0、1、2……索引，原来的数字键不会继续占位。

 'A', 3 => 'B', 8 => 'C'];

// false 表示不要尝试保留原数值键，按遍历顺序从 0 重新编号。
$fixed = SplFixedArray::fromArray($source, false);

// 这里依次得到 A、B、C，对应索引 0、1、2。
foreach ($fixed as $index => $value) {
    // 输出索引和值，确认重排结果而不是猜测键是否被保留。
    echo $index, ': ', $value, PHP_EOL;
}
?>

选择 false 后，不能再依据原数组的键去回查数据。如果还需要原键，应先保留一份键值关系，或者继续使用普通数组，而不是在转换后再试图恢复。

转换前后要检查的三个边界

• 键是否为整数：SplFixedArray 只支持整数索引。字符串键不能像普通数组那样自由使用，尤其在 PHP 8.1 及以后，非整数键访问可能抛出 TypeError。
• 是否真的需要固定长度：它不能自动扩展，数据量未知且频繁追加时，普通数组通常更省事。
• 是否依赖数组函数：固定数组不具备普通数组的全部函数兼容性。转换前先确认后续处理需要的 API 是否支持。

可以用下面的速查表做决定：

常见问题

为什么保留索引后长度比元素个数大？因为长度覆盖了最大数值索引，缺失位置以 null 占位；元素个数和固定数组长度不是一回事。

能不能把 false 理解成删除键？可以理解为“不再保留原数值键并重新编号”，但元素顺序仍按普通数组的遍历顺序决定。

什么时候不该转换？如果代码依赖大量 array_* 函数、需要字符串键，或者容器长度一直变化，普通数组通常更合适。