PHP 数组与只读属性的结合思路

php数组无原生只读属性，但可通过readonly（php 8.1+）限制引用变更、Arrayobject::flag_protect实现内容级防护、getter封装避免引用泄漏，以及phpdoc+静态分析提升类型安全。

PHP 中数组本身没有原生的“只读”属性，但可以通过多种方式模拟或实现只读行为，尤其在面向对象场景中与对象属性结合时，需兼顾安全性、可维护性和 PHP 版本兼容性。

使用 readonly 属性（PHP 8.1+）封装数组

PHP 8.1 引入了 readonly 类属性，适用于标量、对象、数组等类型。注意：readonly 仅保证属性引用不可变，不递归保护数组内部元素。

• 声明为 public readonly array $data; 后，无法重新赋值整个数组（如 $obj->data = []; 会报错）
• 但允许修改数组内容：$obj->data['key'] = 'new'; 或 unset($obj->data['key']); 仍合法
• 若需真正冻结内容，需配合 ArrayObject 或自定义封装

用 ArrayObject + flag 实现深度只读

ArrayObject 支持 ARRAY_AS_PROPS 和 STD_PROP_LIST，配合 setFlags() 可禁用写操作：

• $ro = new ArrayObject([], ArrayObject::ARRAY_AS_PROPS | ArrayObject::STD_PROP_LIST);
• $ro->setFlags(ArrayObject::FLAG_PROTECT); —— 阻止新增/修改/删除元素
• 后续调用 $ro['x'] = 1、unset($ro['x']) 或 $ro->x = 1 均抛出 RuntimeException
• 适合需要运行时动态创建只读数组且要求内容级防护的场景

通过 getter 封装 + 私有属性控制访问

兼容旧版本 PHP 的通用做法：将数组存为 private 属性，仅暴露只读 getter 方法：

立即学习“PHP免费学习笔记（深入）”；

• 返回 array_values($this->data) 或 array_merge([], $this->data) 避免外部引用原数组
• 不提供 setter，也不暴露引用（避免 &$arr = $obj->getData(); $arr[] = ... 修改原数据）
• 可搭配 __get() 拦截属性访问，统一管控逻辑（如日志、权限检查）

类型系统辅助：PHPDoc 与静态分析

即使运行时不强制只读，也可借助类型提示提升协作安全：

• 在 PHPDoc 中标注 @Property-read array $config，提醒开发者该属性只读
• 工具如 PHPStan、Psalm 能识别此类注解，在调用处报错（如误赋值）
• 配合 array{a: int, b: String} 等形状数组类型，进一步约束结构与只读语义