PHP SplFixedArray 和普通数组在固定长度场景如何选择

做固定长度采样、批量槽位或已知容量的中间结果时，PHP 的 SplFixedArray 和普通 array 都能保存数据，但它们解决的不是同一个问题：前者把“容量和整数索引”写进容器契约，后者是更灵活的有序映射。容量已经确定、索引连续且不依赖大量数组函数时，优先考虑 SplFixedArray；输入长度不确定、需要字符串键或频繁使用数组函数时，普通数组更省心。

最容易踩的坑是：SplFixedArray::count() 返回固定容量，不是已经写入的非空元素个数。它会用 null 初始化空槽，所以选择容器前，先确认业务要表达的是“槽位总数”还是“有效数据量”。

先区分两种容器的契约

普通 PHP 数组本质上是 ordered map，既可以当列表，也可以当字典；键可以是整数或字符串，追加元素时容量由运行时管理。SplFixedArray 则像一排预先画好的槽位：构造时指定大小，只允许范围内的整数索引，空槽先是 null。官方手册还明确说明，它的设计目标之一是比标准数组使用更少的内存，但这不等于所有操作都更快。

因此，count($fixed) 和 count($normal) 的含义不能直接类比。固定数组大小为 5 时，即使只写入下标 0 和 2，计数仍是 5；普通数组通常只统计当前存在的元素。若业务要统计有效采样点，应另设计数器，或在遍历时判断值是否为 null，不要把容量当成数据量。

用固定容量写入并处理越界

下面的例子模拟一个容量为 4 的采样窗口。写入前检查索引，既能让错误信息贴近输入，也能避免把“满了以后怎么办”藏在异常里。示例中的输出是代码逻辑的说明，不代表文章配图里的真实执行截图。

 $sample) {
    // 超过容量的输入交给上层决定：截断、分批或报错
    if ($index >= $fixed->getSize()) {
        echo "sample window is full\n";
        break;
    }

    // 只有实际写入后才增加有效数据量
    $fixed[$index] = $sample;
    $validCount++;
}

echo "capacity={$fixed->count()}, valid={$validCount}\n";
// 结果示意：capacity=4, valid=4
?>

这里的两个数字故意分开：capacity 是容器契约，valid 才是本次输入写进去的数量。若确实需要扩大窗口，可以调用 $fixed->setSize(8)；缩小时，新尺寸以后的值会被丢弃，扩大时新增槽位填充为 null，所以调整大小本身也应当是明确的业务动作。

评估普通 array 的灵活性成本

如果数据来自用户提交、分页接口或不确定长度的文件，普通数组通常更合适。你可以直接使用 [] 追加，也能保留业务键名，并继续调用 array_filter()、array_map()、array_column() 等常用函数。迁移到 SplFixedArray 后，很多函数需要先 toArray()，这会引入一次转换和额外的边界判断。

反过来，如果你处理的是一批已知数量的数值、固定列位或大体量连续索引，SplFixedArray 的内存特性可能更有价值。这里的“可能”很重要：PHP 版本、值类型、访问方式和转换次数都会影响结果，不能把官方的内存描述扩大成无条件的性能承诺。应以业务数据规模做小型基准，并把数组函数兼容成本算进去。

按场景落地选择清单

可以用下面的顺序做决定：先问容量能否在创建时确定；再问索引是否始终是连续整数；最后盘点代码是否依赖数组函数、字符串键和动态追加。三个答案都偏向“是、是、否”时，SplFixedArray 才值得引入；只要输入长度经常变化或容器要承担映射职责，普通 array 往往更稳妥。

• 固定采样窗口、固定批次槽位：使用 SplFixedArray，并单独维护有效数量。
• 接口结果、表单字段、键值映射：使用普通 array，保留自然的字符串键。
• 迁移旧代码：先统计数组函数调用，再决定局部替换，避免为了省内存把数据在两种容器之间来回转换。

官方事实可从 PHP 手册的 SplFixedArray 类说明、count() 和 setSize() 页面继续核对；尤其关注当前 PHP 版本对越界访问和异常类型的说明。容器选型的落点不是“谁替代谁”，而是让容量、有效数据和键的语义在代码里各自可见。

常见问题

SplFixedArray 的 count() 能统计已填充元素吗？

不能。它返回设置的大小，空槽也算在内；请单独维护有效计数或自行定义空值规则。

SplFixedArray 可以使用字符串键吗？

不适合。它的索引契约是范围内整数，字符串键会触发类型或范围相关错误；需要字符串键时使用普通数组。

固定数组一定比普通数组快吗？

不一定。它可能减少内存占用，但数组函数缺失、扩容和转换都可能抵消收益，生产选择应以目标数据规模的基准为准。