PHP 8.2中#[AllowDynamicProperties]无效，动态属性弃用问题求助

我正在使用一个暂不支持PHP 8.2的第三方Composer库，需要为应用添加兼容性。该库包含以下类：

class Configuration { }
class ApiClient extends Configuration { }

我自行扩展了类：

class MyApiClient extends ApiClient { }

此时收到错误：[E_DEPRECATED] Creation of dynamic property MyApiClient::$propertyName is deprecated

按预期应该通过添加#[AllowDynamicProperties]属性解决，但添加到MyApiClient后错误仍存在。即使手动修改第三方库文件，给所有父类和子类都添加该属性，问题依旧：

#[AllowDynamicProperties]
class Configuration
{
    public function __construct()
    {
        $this->propertyName = 'foo';
    }
}

#[AllowDynamicProperties]
class ApiClient extends Configuration { }

#[AllowDynamicProperties]
class MyApiClient extends ApiClient { }

错误仍为：[E_DEPRECATED] Creation of dynamic property MyApiClient::$propertyName is deprecated

仅在MyApiClient中显式定义public $propertyName;才能消除错误，但这并非必要操作，请问我遗漏了什么？

核心原因 #

PHP 8.2的#[AllowDynamicProperties]属性不具备继承性。虽然你在父类上添加了该属性，但动态属性是在父类构造函数中赋值给$this的——运行时$this实际指向的是MyApiClient实例，PHP会基于实例所属的类检查是否允许动态属性，而非代码执行所在的父类。

另外，若应用开启了OPcache，旧的类定义可能被缓存，导致新添加的属性未生效，这也是常见的“添加属性后仍报错”的原因。

正确处理方式 #

1. 仅给自己的MyApiClient加属性即可，无需修改第三方库（避免Composer更新覆盖自定义修改）：

#[AllowDynamicProperties]
class MyApiClient extends ApiClient { }

2. 清理OPcache缓存：如果添加属性后警告还在，大概率是OPcache缓存了旧代码。可以重启PHP服务，或者在开发环境调用opcache_reset()清除缓存。
3. 替代方案：如果不想用#[AllowDynamicProperties]，显式定义属性确实是最稳妥的兼容方式——虽然你觉得“非必要”，但这能让代码更清晰，同时彻底解决警告，后续PHP版本升级（比如PHP 9.0会彻底移除动态属性）也能减少适配成本。

为什么修改父类没用？ #

因为PHP检查动态属性时，看的是当前实例的类是否允许，而不是执行赋值代码的类。父类构造里操作的$this是子类实例，所以只有子类标记允许动态属性，才能绕过警告。

内容的提问来源于stack exchange，提问作者MattRogowski