PHP 8.2 升级后动态属性报 Deprecated 警告,旧代码怎么改才不刷屏

PHP 8.2 把动态属性从"能用"改成了"弃用"

从 PHP 8.2 开始,给一个没有声明的属性赋值会触发 DepreCated: Creation of dynamic property 警告。它的意思不是代码跑不起来,而是这个属性在类里找不到定义:8.1 之前 PHP 会默默帮你加上,8.2 之后要求你显式声明。多数老项目升级后日志被这条警告刷满,原因就是几十个模型类和 DTO 类都靠顺手赋值传数据。

第一步:确认警告来源,别和其他弃用提示混在一起

8.2 的弃用提示有好几种,先按关键字过滤,确认是动态属性这一条,再决定改法:

grep -r "Creation of dynamic property" storage/logs/ | head -20

# 典型输出
Deprecated: Creation of dynamic property App\Model\User::$nickname is deprecated
in /var/www/app/Model/User.php on line 42

输出末尾两项信息最有用:类名告诉你改哪个文件,属性名告诉你是漏声明还是拼写错误。如果同一行反复出现,说明赋值发生在循环里,优先处理这个类。

第二步:按场景选改法

最规范的做法是在类里补上属性声明,并写清类型;从数据库或接口来的字段,声明成 public 可空类型即可。第二种是给类加 #[AllowDynamicProperties] 注解,适合第三方库基类或短期改不完的老代码,它只是把警告压掉,不会校验字段。第三种用 __get 与 __set 接管,只在确实要按数组方式存字段时用,否则会丢掉 IDE 补全和静态检查。

// 方式一:显式声明
class User
{
    public ?string $nickname = null;
}

// 方式二:给老基类放行
#[AllowDynamicProperties]
class LegacyBase {}

注意子类不会继承父类的动态属性许可。如果警告出现在子类实例上,要在子类自己头上加注解,这也是升级后同一条警告反复出现的原因。

第三步:用静态分析一次性扫干净

日志只能抓到你实际访问过的代码路径,没跑到的分支照样埋着雷。装 PHPStan 扫一遍,能把漏声明的属性提前列出来:

composer require --dev phpstan/phpstan
vendor/bin/phpstan analyse app --level=5

级别从 0 开始逐级往上调,先让 level 5 跑通,再考虑收紧。扫描报出的 Access to an undefined property 基本就是 8.2 会报警告的位置。

小结

处理顺序是:按关键字确认警告类型,补属性声明,无法改动的基类加注解,最后用 PHPStan 补扫未覆盖的分支。改完再把 error_reporting 打开跑一轮,确认日志干净,升级才算收尾。

您可以还会对下面的文章感兴趣: