php 8.6.0 移除了只读属性(readonly properties)的默认值特性,导致原本在 php 8.4.27 中合法的代码在升级后报错。要适配这一变更,必须移除类属性声明中的 `= value` 赋值,并将该值改为通过构造函数参数传递并在初始化时赋值。

如何修改只读属性的声明以消除语法错误
在 PHP 8.6.0 中,直接对只读属性进行默认赋值会抛出 SyntaxError。解决此问题的方法是将属性声明简化为仅包含类型和修饰符,不再附带等号和初始值。例如,将 public readonly string $name = 'default'; 修改为 public readonly string $name;。这样既符合新版本的语法规则,又保留了只读语义。

class User {
// 旧写法 (PHP 8.4.27 合法,8.6.0 报错)
// public readonly string $role = 'guest';
// 新写法 (PHP 8.6.0 兼容)
public readonly string $role;
public function __construct(string $role) {
$this->role = $role;
}
}
$user = new User('admin');
echo $user->role; // 输出: admin
如何在构造函数中正确初始化只读属性
由于无法在声明时赋予默认值,所有只读属性必须在构造函数的执行过程中被赋值一次。这要求调用方在实例化对象时必须提供必要的参数。如果某些属性需要“可选”行为,可以通过在构造函数参数中设置默认值来实现,而不是在属性声明中设置。这种模式确保了对象在创建完成后,其状态是不可变的。
修复 Core bailout 状态损坏安全问题,以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误,改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
立即学习“PHP免费学习笔记(深入)”;

class Config {
public readonly string $host;
public readonly int $port;
// 通过参数默认值模拟原属性默认值的行为
public function __construct(
string $host,
int $port = 8080
) {
$this->host = $host;
$this->port = $port;
}
}
// 使用默认端口
$config = new Config('localhost');
echo $config->port; // 输出: 8080
迁移后如何处理原有的默认逻辑
对于原本依赖属性默认值的业务逻辑,现在需要将这些逻辑转移到构造函数或工厂方法中。如果在原有代码中,默认值是基于复杂计算得出的,那么这些计算应当封装在构造函数内部。这样做不仅解决了语法兼容性问题,还使得对象的初始化逻辑更加集中和可控。开发者应检查所有使用了只读属性的类,确保每个属性都有明确的赋值路径,避免未初始化导致的运行时错误。


















