如何配置重构脚本一键将不规范的旧属性平滑无损地升级为标准方法-js教程-PHP中文网

旧属性平滑升级的核心是构建可验证、可回退、语义不变的重构流水线；需先识别public成员变量、数组式属性、全局配置项、魔术属性等目标，再用phpstan/ psalm扫描，rector自动生成getter/setter骨架。

如何配置重构脚本一键将不规范的旧属性平滑无损地升级为标准方法

要让旧属性平滑升级为标准方法，核心不是“一键运行脚本”，而是构建一个可验证、可回退、语义不变的重构流水线。关键在于把“属性访问”这种隐式行为，显式转化为符合现代规范的封装方法（如 getter/setter），同时确保所有调用点自动适配、不破坏功能。

明确哪些旧属性需要升级

先识别目标，避免盲目替换。常见需升级的旧属性包括：

public 成员变量直接读写（如 $user->name）
未封装的数组式属性（如 $config['db_host']）
全局或静态变量暴露的配置项（如 CONFIG_DB_HOST）
魔术属性（__get/__set 中未统一校验的字段）

建议用 PHPStan 或 Psalm 扫描出所有未声明类型、无访问控制的属性，并导出清单作为重构输入。

用 Rector 自动注入标准方法骨架

Rector 是目前最可靠的自动化工具，支持按版本渐进生成 getter/setter，并保留原有逻辑。配置示例如下：

<?php use Rector\Config\RectorConfig;
use Rector\Set\ValueObject\SetList;

return RectorConfig::configure()
    ->withPaths(['src/'])
    ->withSets([
        SetList::CODE_QUALITY, // 启用基础质量规则
        SetList::PHP_80,       // 确保语法兼容性
    ])
    ->withRules([
        \Rector\Php80\Rector\Class_\ReorderPropertiesAndConstantsRector::class,
        \Rector\CodeQuality\Rector\Class_\InlineConstructorSettersRector::class,
        \Rector\CodeQuality\Rector\Class_\AddGetterAndSetterMethodRector::class,
    ]);

执行命令：vendor/bin/rector process src/ --dry-run 预览变更；确认无误后去掉 --dry-run 实际应用。

Vidu Claw

一款AI视频创作工具，主要用于Vidu AI打造的多模态AI视频创作智能体，内置Vidu Skills，支持OpenClaw调用，适合需要提升相关任务效率的用户。

下载

保持向后兼容：代理旧属性访问

升级后不能让老代码崩掉。Rector 生成的方法默认不接管旧属性访问，需手动加一层兼容层：

在类中保留原 public 属性（暂不删），但标注 @deprecated
重写 __get() 和 __set()，将对属性的读写转发到新方法：
if ($name === 'name') { return $this->getName(); }
对数组式配置，封装成 Config::get('db_host')，内部仍支持旧键名映射

这样既启用新方法，又不中断现有调用，为后续彻底移除旧属性留出缓冲期。