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

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])→true;array_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()检查后,类型推导更精准,减少运行时错误










