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。因此,扩容本身不会替你填充默认业务对象。

用 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 的值位于新尺寸之外,会被丢弃;这不是把数组“压紧”后保留全部内容。若这些值仍有业务意义,先转成普通数组或逐项迁移,再执行缩容。

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() 备份或先完成迁移。
-
402 收藏
-
222 收藏
-
198 收藏
-
335 收藏
-
297 收藏
-
331 收藏
-
493 收藏
-
157 收藏
-
447 收藏
-
文章 · php教程 | 21小时前 | 文件处理 · 面向对象 · php教程 · php SplFileInfo SplFileInfo::getFileInfo getFileInfo setInfoClass 文件信息对象500 收藏
-
文章 · php教程 | 22小时前 | 正则表达式 · 迁移 · php教程 · php split replace MATCH RegexIterator getMode GET_MATCH ALL_MATCHES344 收藏
-
177 收藏
-
文章 · php教程 | 23小时前 | 反射 · php教程 · php 函数反射 ReflectionFunction ReflectionFunctionAbstract getExtensionName238 收藏
-
330 收藏
-
165 收藏
-
469 收藏
-
287 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习