当前位置:首页 > 文章列表 > 文章 > php教程 > PHP SplFixedArray 怎样扩容并保留已有元素

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

来源:17golang原创 2026-11-19 15:19:34 0浏览 收藏

我在把固定长度的配置槽位改成可按批次增长时,最先确认的是: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删除
PHP SplFileObject.setCsvControl 怎样改变 CSV 分隔符PHP SplFileObject.setCsvControl 怎样改变 CSV 分隔符
上一篇
PHP SplFileObject.setCsvControl 怎样改变 CSV 分隔符
PHP mb_check_encoding 怎样检查字符串是否为有效 UTF-8
下一篇
PHP mb_check_encoding 怎样检查字符串是否为有效 UTF-8
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • PubMedQA数据集详解:生物医学问答基准、功能与应用指南
    PubMedQA
    深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
    1118次使用
  • H2O EvalGPT:开源LLM大模型评估与排行榜工具
    H2O EvalGPT
    H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
    1106次使用
  • LMArena是什么?伯克利AI模型评估平台使用指南与功能解析
    LMArena
    LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
    1278次使用
  • 斯坦福HELM:大语言模型Holistic Evaluation整体评估框架详解
    HELM
    深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
    1221次使用
  • MMBench详解:多模态大模型基准测试、功能特点与使用指南
    MMBench
    MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
    1069次使用