PHP 新版本中数组相关特性汇总

5次阅读

php 8.1起支持readonly数组属性,8.2新增Array_is_list()及数组形状类型注解,8.3支持解构尾部省略语法;readonly仅防属性重赋值,不防元素修改,真正只读需封装

PHP 新版本中数组相关特性汇总

PHP 8.1 起支持只读数组(readonly arrays)

PHP 8.1 引入了 readonly 关键字,可用于类属性,间接支持“只读数组”语义。虽然 PHP 没有原生的 readonly array 类型,但可通过 readonly 属性 + 数组类型声明实现运行时保护:

  • 声明为 public readonly array $data; 的属性,初始化后不可重新赋值(包括 $obj->data = [...]$obj->data[] = ...
  • 注意:只阻止对整个属性的写入,不阻止对数组内部元素的修改(如 $obj->data[0] = 'new' 仍允许)——真正只读需配合 ArrayObject 或自定义封装
  • 适合用作配置、映射表等不应被意外覆盖的结构化数据容器

PHP 8.2 新增 array_is_list() 函数

用于准确判断一个数组是否为「列表」(即键为连续数字且从 0 开始)。此前需手动检查 array_keys($arr) === range(0, count($arr)-1),易出错且低效。

  • array_is_list([]) 返回 true
  • array_is_list([1, 2, 3])truearray_is_list([1 => 'a', 2 => 'b'])false
  • json 编码、函数参数校验、API 响应格式预判等场景中可替代模糊的 is_array() + 键名检测逻辑

PHP 8.3 支持数组解构中的尾部省略语法(Trailing comma in array destructuring)

允许在解构赋值中使用尾随逗号,提升可读性与版本控制友好性:

  • 写法示例:[$a, $b, , $d,] = $arr; —— 跳过第三个元素,末尾逗号合法
  • 与函数调用、数组字面量中的尾随逗号行为一致,降低合并冲突概率
  • 不改变语义,纯语法糖,不影响性能

类型系统增强:数组形状(Array Shapes)在 PHP 8.2+ 更实用

PHP 8.2 正式支持更严格的数组结构类型注解(虽非语言级强制,但被主流静态分析器如 PHPStan、Psalm 广泛支持):

立即学习PHP免费学习笔记(深入)”;

  • 可写为 array{ id: int, name: String, tags?: list<string> }</string>
  • 支持可选键(?)、联合类型(int|string)、嵌套结构、list<t></t>
  • 结合 array_key_exists()isset() 检查后,类型推导更精准,减少运行时错误
text=ZqhQzanResources