登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  文章 >  php教程

PHP SplFixedArray 怎样扩容并保留已有元素

来源:17golang原创

时间:2026-11-19 15:19:34 121浏览 收藏

我在把固定长度的配置槽位改成可按批次增长时,最先确认的是:SplFixedArray::setSize() 扩容不会重排已有索引,新增位置会得到 null;真正需要谨慎的是缩容,因为新尺寸之外的值会被丢弃。官方地址:https://www.php.net/manual/en/splfixedarray.setsize.php

实践要点
  • 扩容只改变尺寸,原有整数索引和值保持原位置。
  • 新尺寸变大时,新增槽位按 null 处理,不能直接当成已填数据。
  • 缩容前先备份或迁移新尺寸之外的索引,负数尺寸会抛出 ValueError。

扩容规则先看清:旧索引保留,新位置是 null

SplFixedArray 的容量不是普通 PHP 数组那样自动增长,而是由尺寸明确界定。调用 setSize(8) 把长度从 5 调到 8 时,索引 0 到 4 的值仍在原位置,索引 5 到 7 是新增槽位,初始值为 null。因此,扩容本身不会替你填充默认业务对象。

SplFixedArray 扩容后保留已有索引并补充 null 槽位的静态结构说明图
图1:SplFixedArray 扩容关系说明图,展示旧索引保留与新增 null 槽位。

用 setSize 扩容并核对元素位置

下面的写法适合批量追加槽位:先读取旧尺寸,再设置更大的尺寸,最后检查旧值和新增位置。示例中的注释只说明关键边界,不把图示当成实际运行截图。

setSize(8);

// getSize() 反映新容量;新槽位仍是 null
printf("size=%d, old=%s, new=%s%s", $items->getSize(), $items[1], var_export($items[6], true), PHP_EOL);

// 业务写入必须落在新尺寸范围内,避免把 null 当成有效记录
$items[6] = 'gamma';
echo $items[1], " / ", $items[6], PHP_EOL;
?>

这里的核对重点是三件事:getSize() 返回 8,$items[1] 仍为 alpha,而没有写入的 $items[6] 先是 null。需要默认值时,应在业务层显式填充,而不是把扩容误认为初始化流程。

缩容前保存边界数据

缩容和扩容不是对称的。把尺寸从 6 调成 3 后,索引 3、4、5 的值位于新尺寸之外,会被丢弃;这不是把数组“压紧”后保留全部内容。若这些值仍有业务意义,先转成普通数组或逐项迁移,再执行缩容。

SplFixedArray 缩容时保留区与截断区边界的静态说明图
图2:缩容边界静态说明图,区分新尺寸以内的保留数据与边界之外的丢弃数据。
toArray();
$newSize = 3;

// 只有索引 0 到 2 属于缩容后的范围,3 之后会被丢弃
$items->setSize($newSize);
echo $items[0], " / ", $backup[5], PHP_EOL;
?>

如果目标是“只保留前 N 个槽位”,可以直接缩容;如果目标是“减少容量但保留所有非空项”,就不能直接调用 setSize(),需要先定义新的索引布局并重新写入。

参数、异常与普通数组的取舍

setSize() 的尺寸应是非负整数。传入负数会抛出 ValueError,所以动态尺寸最好先做边界判断,并把异常转换成调用方能理解的错误。PHP 8.4 的手册还标记了返回值 true 的暂定变化;代码不应依赖一个特定版本的返回值来判断“是否扩容成功”,应以异常和随后读取到的尺寸为准。

这种结构适合容量边界明确、需要整数索引且希望显式管理槽位的场景。若数据需要频繁插入、删除、自动增长,或缩容时必须保留全部元素,普通数组通常更直接。无论选择哪一种,都要把“容量变化”和“业务数据迁移”分成两个动作。

相关问题

扩容后已有索引会重新编号吗?

不会。扩容改变的是尺寸上限,已有索引和值仍在原位置;只有你主动改写下标,数据布局才会变化。

缩容后还能读取被裁掉的元素吗?

不能从缩容后的 SplFixedArray 读取。需要保留时,应在调用 setSize() 前使用 toArray() 备份或先完成迁移。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>