PHP SplFixedArray 和普通 array 怎么选：固定容量、越界异常与遍历结果

批处理任务进入队列时，开发者经常会在两个方向之间犹豫：继续使用灵活的 PHP array，还是把容量写死在 SplFixedArray 里。这个选择不只是“哪个更快”，而是要先看数据有没有明确的槽位边界，以及越界时应该静默扩容还是立即暴露错误。

先看任务队列到底需要哪种边界

如果一批任务的槽位数量来自协议或设备配置，容量是数据的一部分，写错索引应该尽早暴露。SplFixedArray 适合这种场景：构造时给出大小，索引只能是范围内的整数，扩容必须显式调用 setSize()。

如果数据来自用户筛选、分页结果或不断增长的日志，普通 array 更自然。它能追加元素，也能使用字符串键，调用方无需先维护容量状态。

固定槽位如何表现空值和越界

下面的示例刻意只写入 0 和 2，中间位置保留为空，再尝试写入索引 3。代码和终端截图使用的是同一个 example.php，先观察结果，再决定数据结构。

getSize() . " count=" . $fixed->count() . PHP_EOL;
echo "fixed slots=" . json_encode($fixed->toArray()) . PHP_EOL;

try {
    $fixed[3] = 'overflow';
} catch (RuntimeException $exception) {
    echo "fixed overflow=" . $exception->getMessage() . PHP_EOL;
}
?>

这里有两个容易误读的点。第一，count() 返回的是固定大小，不是已赋值元素数量；第二，toArray() 会把未写入的槽位转换成 null。越界时终端会给出 Index invalid or out of range。这正是“槽位模型”，不是普通列表的“已加入多少项”。

普通 array 为什么更适合动态集合

同一个示例里，普通 array（normal array）可以直接追加 queue-4，不需要先调用扩容方法。它的代价是索引边界不会替你表达，业务代码必须自己决定是否允许追加、是否拒绝重复键。

$normal = ['queue-1', 'queue-3'];
$normal[] = 'queue-4';
echo "normal count=" . count($normal) . " last=" . $normal[array_key_last($normal)] . PHP_EOL;

因此，普通 array 并不是“功能少的固定数组”。它本身就是 PHP 里更通用的有序哈希表；业务集合通常更需要它的可变长度和键值能力。

选择前先确认三个实际成本

固定容量是否真的来自外部契约？

如果容量来自协议、设备通道或批次规格，SplFixedArray 能把违规写入变成明确异常。如果容量只是“估计不会超过 100”，不要把猜测写成硬约束。

调用方是否依赖字符串键和追加语法？

依赖 $items['status']、$items[] 或大量数组函数的代码，迁移到 SplFixedArray 前要先核对接口；它只接受范围内整数索引。

是否把内存数字当成唯一目标？

官方手册说明固定数组相较标准 array 可能更省内存，但真实收益要用项目数据量和 PHP 版本压测确认。先保证索引语义正确，再做基准比较。

相关问题

SplFixedArray 可以自动追加元素吗？

不能按普通数组的方式自动追加；需要先用 setSize() 扩大范围，再写入新的整数索引。

SplFixedArray 的 count 是已赋值数量吗？

不是。它返回固定大小，未写入的位置仍是槽位，转成普通数组时通常显示为 null。

越界读取和越界写入怎么处理？

超出定义范围的索引会触发 RuntimeException，应在调用前保证索引来自可信范围，或捕获异常记录输入问题。

结论

当“有多少个槽位”本身就是业务规则时，用 SplFixedArray 让容量和越界行为显式化；当集合要自由追加、使用字符串键或频繁交给数组函数处理时，普通 array 更稳妥。先按数据契约选结构，再用真实负载验证内存和速度，通常比凭感觉替换更可靠。