PHP 8.5 final 属性怎么阻止子类改写：构造器提升属性与继承验收

订单实体里有些字段一旦进入对象，就不应该被子类重新定义：例如订单号、租户号和创建时间。过去 PHP 只能把这类约束写进文档或测试，PHP 8.5 现在允许在构造器属性提升中声明 final 属性，让继承关系直接拒绝同名重声明。

一个子类重声明就会改变什么

先看一段常见的订单基类：

class Order
{
    public function __construct(
        public readonly string $orderId,
        public readonly int $tenantId,
    ) {}
}

class GiftOrder extends Order
{
    public string $orderId = '';
}

子类的 $orderId 与父类同名，既可能造成类型和可见性不一致，也会让序列化、反射和调试结果变得难以判断。真正想表达的规则不是“请不要改”，而是“这个字段属于基类契约，子类不能重新声明”。

PHP 8.5 的 final 属性写法

PHP 8.5 可以直接把 final 放在构造器属性提升的位置：

class Order
{
    public function __construct(
        final public readonly string $orderId,
        final public readonly int $tenantId,
    ) {}
}

class GiftOrder extends Order
{
    public string $orderId = '';
}

加载 GiftOrder 时，PHP 会报告子类尝试重新声明 final 属性。这里的保护发生在继承结构建立阶段，不依赖某个业务方法是否被调用，适合身份字段、租户边界和不可替换的基础配置。

哪些改动会被挡住，哪些仍然允许

final 解决的是“不能重新声明”，readonly 解决的是“初始化后不能写入”，二者职责不同。把它们放在一起，才能同时守住继承边界和对象状态。

给订单实体补一组可执行验收

不要只检查代码能否解析，建议把继承边界写成最小测试：

$order = new GiftOrder('A-1001', 7);
assert($order->orderId === 'A-1001');
assert($order->tenantId === 7);

// 反例：GiftOrder 不应再次声明 orderId
// 预期：加载类时失败，而不是运行到业务方法才发现

1. 正常实例化：确认构造器提升属性仍能由子类继承和读取。
2. 重声明检查：在测试夹具中临时声明同名属性，确认 PHP 8.5 拒绝加载。
3. 状态检查：尝试修改 readonly 字段，确认错误发生在错误位置，而不是静默改变订单身份。
4. 反射检查：用 ReflectionProperty 核对名称、可见性、类型和 final 标志，防止重构时漏掉契约。

兼容 PHP 8.4 的迁移写法

PHP 8.4 没有这项属性级别的保护。若项目需要双版本运行，可以先使用显式属性声明，把字段集中在父类中：

class Order
{
    public readonly string $orderId;
    public readonly int $tenantId;

    public function __construct(string $orderId, int $tenantId)
    {
        $this->orderId = $orderId;
        $this->tenantId = $tenantId;
    }
}

这能保留类型和只读约束，但不能替代 PHP 8.5 的 final 属性。兼容阶段应额外保留一条“子类不得重声明”的继承测试，升级到 8.5 后再把它收敛为语言级契约。

常见问题

final 属性和 final 类是一回事吗？

不是。final 类禁止整个类被继承，final 属性只禁止子类重新声明指定属性，子类仍可以继承并扩展其他行为。

子类还能修改 final 属性的值吗？

如果属性同时是 readonly，初始化后不能修改；final 本身主要约束声明，不负责对象值的写入权限。

构造器属性提升必须使用 final 吗？

不必须。只有当字段属于稳定的父类契约、子类重声明会破坏语义时才应该使用。

PHP 8.4 项目可以提前写这套代码吗？

可以先采用显式属性和继承测试，但 PHP 8.4 不会提供 final 属性的语言级重声明保护，部署前仍需按运行版本验收。

让身份字段在继承树里保持唯一

PHP 8.5 的 final 属性适合放在少数关键字段上，而不是给所有属性加限制。先识别订单号、租户号这类一旦改变就会影响路由、审计和权限的字段，再用 final readonly 组合约束，最后用 PHP 8.4 兼容测试和 PHP 8.5 继承失败测试各验一次，改造边界会很清楚。