PHP SPLFixedArray 和普通数组有什么取舍

如果 PHP 数据是“长度大致确定、只按 0 到 n-1 的整数位置访问”，SplFixedArray 值得考虑；如果数据需要字符串键、动态追加、删除或大量现成数组函数，普通 array 通常更省心。两者的差别首先是数据结构约束，其次才是内存取舍，不能只因为名字里有 Fixed 就把它当成更快的通用数组。

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

先看两种容器到底约束了什么

PHP 手册把普通 array 定义为有序 map。它既能像列表一样使用，也能保存字符串键、混合键和嵌套结构。这个灵活性正是它适合业务代码的原因，但也意味着“一个数组只有连续整数索引”只是使用方式，不是容器本身的硬约束。

SplFixedArray 则明确表达了另一种契约：创建时先给出长度，索引必须是有效范围内的整数，长度变化要显式调用 setSize()。手册还指出它的内存占用通常低于标准数组，但这不等于所有访问或业务代码都会自动更快。

最小代码：长度和索引行为不同在哪里

下面的例子故意把长度、空槽和遍历放在一起。代码中的中文注释说明了每个操作的边界，便于直接改成自己的批处理或采样数据。

getSize(), PHP_EOL;    // 3：容器长度，不等于已写入数量

foreach ($fixed as $index => $value) {
    // 遍历会经过固定范围，空槽的值是 null。
    var_dump($index, $value);
}
?>

这里最容易误判的是 count($fixed) 与“已经填了几个值”不是一回事。固定数组长度为 3，即使中间仍是 null，它也仍然有 3 个位置。若业务只关心已收集记录数，需要单独维护计数，不能把容器长度当作有效数据量。

扩容、缩容和数组函数会带来迁移成本

SplFixedArray 不是不可变数组，但修改长度必须显式做决定。setSize(5) 会把新位置补成 null；缩小长度时，超出新边界的值会被丢弃；传入负数会抛出 ValueError。因此，缩容不能放在一个不经确认的清理分支里。

普通数组的操作习惯也不能原样搬过来。字符串键、自动追加，以及围绕普通数组设计的许多函数，都需要先确认参数类型和返回类型。需要与 JSON、第三方 SDK 或框架集合层频繁互换时，可以在边界处调用 toArray()，但转换本身也意味着一次额外的数据组织动作。

setSize(6);

// 缩容前先判断边界，避免无意中丢掉索引 4 之后的值。
if ($slots->getSize() > 4) {
    $slots->setSize(4);
}

// 对外部接口需要普通数组时，在明确的边界位置转换。
$payload = $slots->toArray();
echo json_encode($payload, JSON_UNESCAPED_UNICODE), PHP_EOL;
?>

按数据形状做选择

把“省内存”当成唯一理由，往往会忽略更贵的迁移成本。先问数据有没有字符串键、长度能否预估、是否会频繁追加和删除，再决定容器。

一个可落地的选择顺序

1. 先写出索引契约：是否只允许连续整数，空槽是否有业务含义。
2. 再写出长度契约：初始长度从哪里来，扩容和缩容由谁负责，缩容是否允许丢数据。
3. 列出边界调用：是否需要字符串键、array_*() 函数、JSON、ORM 或 SDK 的普通数组参数。
4. 最后再做小规模基准或内存观测，用真实数据量和真实访问方式比较，不把手册的“较少内存”直接改写成固定性能承诺。

如果前三项无法说清，继续使用普通数组通常是更稳妥的工程决定；如果它们都明确，且内存确实是瓶颈，再把一个局部容器替换为 SplFixedArray，在边界统一转换和测试。

常见问题

SplFixedArray 能不能使用字符串键？

不能把它当关联数组使用。它要求索引是有效范围内的整数；需要字符串键时，普通 array 更合适。

SplFixedArray 的长度等于有效数据条数吗？

不一定。长度表示槽位数量，未写入的位置也会占据索引并返回 null。有效记录数需要由业务代码另行统计。

只为了性能就应该换成 SplFixedArray 吗？

不应该。它的主要价值是更明确的定长整数槽位契约和潜在的内存节省。是否更快、是否值得转换，要用自己的数据规模和调用链测量。

总结

PHP SplFixedArray 与普通数组不是简单的“新旧替代关系”。连续整数索引、长度可预估、空槽有明确含义时，它能让数据边界更清楚；字符串键、动态追加、频繁删除和框架接口兼容优先时，普通 array 更自然。先按数据形状做选择，再用真实观测确认内存收益，迁移才不会变成只换容器名称。