0

0

PHP怎样声明变量为只读_PHP声明变量为只读属性【属性】

絕刀狂花

絕刀狂花

发布时间:2026-02-25 17:11:03

|

185人浏览过

|

来源于php中文网

原创

php 8.1+ 使用 public readonly type $prop 声明只读属性,必须在构造函数中首次且仅赋值一次,引擎级强制不可变,不支持 static、嵌套只读或无类型声明。

php怎样声明变量为只读_php声明变量为只读属性【属性】

PHP 8.1+ 怎么用 readonly 声明只读属性

PHP 本身没有“只读变量”概念,只有“只读属性”(readonly),且仅支持类属性,不能用于普通变量或函数内局部变量。它从 PHP 8.1 开始引入,底层是编译期强制约束,不是靠魔术方法模拟。

常见错误现象:Fatal error: Cannot assign to readonly property —— 这不是警告,是致命错误,一旦在构造函数外写入就崩。

  • readonly 只能修饰类属性,语法为 public readonly int $id;
  • 必须在构造函数中完成首次赋值,且只能赋一次;之后任何写操作(包括 $obj->prop = ... 或反射)都会报错
  • 不支持 static readonly,也不支持 readonly 数组元素或对象属性嵌套(如 $obj->data->name 不受保护)
  • 类型必须显式声明,不支持 mixed 或无类型(PHP 8.2+ 允许 readonly ?string,但依然要类型标注)

为什么不能用 __get/__set 模拟 readonly 属性

手动实现 getter/setter 看似灵活,但本质是运行时防护,绕过方式太多:反射、serialize/unserialize、直接改 $this->prop(如果没设为 private)、甚至数组强制转换都能破坏封装。

readonly 是引擎级保障,连反射都不能修改(ReflectionProperty::setValue() 会抛 TypeError)。

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

知元AI
知元AI

AI智能语音聊天 对讲问答 AI绘画 AI写作 AI创作助手工具

下载
  • __set 无法拦截 $obj->prop = ... 对 public 属性的直接赋值(除非属性设为 private + 魔术方法,但 public readonly 就是为简化而生)
  • __get/__set 会带来性能开销,尤其高频访问场景;readonly 零额外成本
  • IDE 和静态分析工具(如 PHPStan)能识别 readonly 并提示误写,对魔术方法则基本无感知

readonly 属性在 DTO 和实体类中的典型用法

最适合用在数据传输对象(DTO)、值对象(VO)或不可变实体上,比如 API 返回的用户信息、数据库查询结果封装。

示例:

class UserDto
{
    public function __construct(
        public readonly string $name,
        public readonly int $age,
        public readonly ?string $email = null,
    ) {}
}
  • 构造参数自动绑定到 readonly 属性,省去手写赋值语句
  • 允许默认值(如 ?string),但注意:默认值不算“首次赋值”,仍需在构造时显式传入或由参数默认值触发
  • 不要试图在构造函数体里再赋值:$this->name = $name; 是冗余且易错的(可能覆盖参数绑定)
  • 兼容性注意:PHP 8.0 及更早版本完全不识别 readonly 关键字,会解析失败

readonly 和 const、final 的区别与误用场景

const 是类常量,属于类而非实例,所有实例共享;final 修饰类或方法,跟属性可变性无关;readonly 是每个实例独立持有的、初始化后不可变的属性。

  • 别用 const 存实例数据:比如 const CREATED_AT = time(); 会报错,因为 const 必须是编译期常量
  • final class 不影响内部属性是否可写,和 readonly 无关
  • 误以为 private $x; final public function getX() { return $this->x; } 就安全了——其实 $x 本身仍可被反射或序列化篡改
  • PHP 8.2+ 支持 readonly class,表示整个类所有属性都隐式 readonly,但目前仅限于没有构造函数的纯数据类(仍有诸多限制)

真正难处理的是嵌套可变性:一个 readonly 对象属性,其内部字段仍可被修改。比如 public readonly DateTime $createdAt;,你不能改 $dto->createdAt,但可以调 $dto->createdAt->modify('+1 day') —— 这种得靠设计约束或文档约定,语言层管不到。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

850

2023.08.02

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1559

2023.10.24

scripterror怎么解决
scripterror怎么解决

scripterror的解决办法有检查语法、文件路径、检查网络连接、浏览器兼容性、使用try-catch语句、使用开发者工具进行调试、更新浏览器和JavaScript库或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

391

2023.10.18

500error怎么解决
500error怎么解决

500error的解决办法有检查服务器日志、检查代码、检查服务器配置、更新软件版本、重新启动服务、调试代码和寻求帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

348

2023.10.25

c语言const用法
c语言const用法

const是关键字,可以用于声明常量、函数参数中的const修饰符、const修饰函数返回值、const修饰指针。详细介绍:1、声明常量,const关键字可用于声明常量,常量的值在程序运行期间不可修改,常量可以是基本数据类型,如整数、浮点数、字符等,也可是自定义的数据类型;2、函数参数中的const修饰符,const关键字可用于函数的参数中,表示该参数在函数内部不可修改等等。

552

2023.09.20

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

850

2023.08.02

int占多少字节
int占多少字节

int占4个字节,意味着一个int变量可以存储范围在-2,147,483,648到2,147,483,647之间的整数值,在某些情况下也可能是2个字节或8个字节,int是一种常用的数据类型,用于表示整数,需要根据具体情况选择合适的数据类型,以确保程序的正确性和性能。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

584

2024.08.29

c++怎么把double转成int
c++怎么把double转成int

本专题整合了 c++ double相关教程,阅读专题下面的文章了解更多详细内容。

294

2025.08.29

batoto漫画官网入口与网页版访问指南
batoto漫画官网入口与网页版访问指南

本专题系统整理batoto漫画官方网站最新可用入口,涵盖最新官网地址、网页版登录页面及防走失访问方式说明,帮助用户快速找到batoto漫画官方平台,稳定在线阅读各类漫画内容。

126

2026.02.25

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 12.4万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 11.3万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 0.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号