开发工具代码质量静态分析【免费下载链接】phpstanPHP Static Analysis Tool - discover bugs in your code without running it!项目地址https://gitcode.com/gh_mirrors/ph/phpstan点击查看免费下载PHPStan 在分析new ClassName()语句时会通过new.deprecatedClass错误标识符报告对已被deprecated标记的类的实例化行为。本文以 PHPStan 官方错误文档为骨架结合仓库中的标识符注册表与扩展安装指引系统讲解该错误的触发机制、与 phpstan-deprecation-rules 扩展的关系、常见修复路径以及同一规则族new.deprecatedEnum/new.deprecatedInterface/new.deprecatedTrait在代码现代化迁移中的实战价值。读完本文你将能识别、复现并消除此类弃用警告为升级到 PHPStan 2.0 及后续大版本扫清障碍。错误标识符是什么PHPStan 的机器可读错误 IDPHPStan 的每一条分析错误都带有一个稳定的、机器可读的错误标识符error identifier格式通常为命名空间.规则名。它让开发者、CI 工具和 IDE 能够精确地区分不同类型的错误并在配置文件中针对性地处理例如通过reportUnmatchedIgnoredErrors追踪忽略项、或按 identifier 定向忽略。new.deprecatedClass便是其中一员。从仓库的标识符注册表 errorsIdentifiers.json 可以看到该标识符由PHPStan\Rules\Deprecations\RestrictedDeprecatedClassNameUsageExtension规则类产生归属phpstan/phpstan-deprecation-rules扩展包注册表条目。该规则同时负责new.deprecatedEnum、new.deprecatedInterface、new.deprecatedTrait等同族标识符并指定了扩展包源码 RestrictedDeprecatedClassNameUsageExtension.php 作为实现参考。错误标识符文档的统一规范见 website/errors/CLAUDE.md每份文档由title、shortDescription、ignorable三段 frontmatter 与Code example / Why is it reported? / How to fix it三节正文构成。其中ignorable: true表明该错误允许通过ignoreErrors配置被忽略前缀new对应 PHP 语言中的new ClassName()实例化表达式见 CLAUDE.md 中的 标识符前缀参考表。触发场景一段最小化复现代码以下代码即可稳定触发new.deprecatedClass?php declare(strict_types 1); /** deprecated Use NewLogger instead */ class OldLogger { } new OldLogger();两个关键要素缺一不可类被deprecated标记PHPDoc 注释中的deprecated标签是 PHPStan以及大多数静态分析工具识别弃用信息的标准途径可附带推荐替代品的说明例如本例中的Use NewLogger instead用new实例化该被弃用的类new OldLogger()是整条规则的检查对象。只要以上条件成立PHPStan 就会在分析结果中输出一条携带new.deprecatedClass标识符的错误。为什么会被报告扩展规则与弃用语义规则来自 phpstan-deprecation-rules 扩展而非 PHPStan 核心new.deprecatedClass并非 PHPStan 核心内置规则而是由官方扩展包 phpstan-deprecation-rules 中该扩展被列为 PHPStan 生态中负责弃用检测Deprecation detection的组件UPGRADING.md 在 PHPStan 2.0 升级指南中也明确要求用户安装并启用 phpstan-deprecation-rules。若未安装该扩展上述代码不会报出此错误。这也是理解该标识符的第一原则它的出现以扩展启用为前提。语言层面的弃用语义从 PHP 语言视角看deprecated是一个约定俗成的 PHPDoc 约定标记某个类不再推荐使用可能在未来的版本中被移除。它本身不会触发 PHP 运行时的任何行为——类仍然可以正常new、正常调用。因此使用被弃用的类不会导致程序崩溃但会让新代码建立在即将被移除的实现之上形成技术债在库/框架升级时造成连锁弃用——你依赖的类被删除后调用方必须同步改造掩盖真正值得关注的架构演进方向文档给出的弃用原因通常指明了推荐替代品。new.deprecatedClass的价值正在于把这种沉默的隐患提前暴露在 CI 阶段而非等到运行时或升级时才暴露。规则族与触发面的全覆盖同类规则还覆盖了其他使用被弃用类名的场景例如attribute.deprecatedClass属性attribute引用了被弃用的类attribute.deprecatedClass.mdassert.deprecatedClassphpstan-assert断言引用了被弃用的类assert.deprecatedClass.mdclass.extendsDeprecatedClass继承自被弃用的类class.extendsDeprecatedClass.mdnew.deprecatedEnum/new.deprecatedInterface/new.deprecatedTraitnew被弃用的枚举、接口或 trait。这些标识符共同构成 phpstan-deprecation-rules 对类名使用位置ClassNameUsageLocation的完整审计网络——凡是在继承、实现、实例化、属性、断言、捕获、方法调用等位置出现被弃用的类名都会得到对应标识符的错误提示。如何修复三步替换法第一步替换为推荐的替代类修复的核心动作是把被弃用的类替换为deprecated注释中推荐的替代品-new OldLogger(); new NewLogger();如果原类没有在deprecated注释中指明替代品需要到该类所在的库文档、CHANGELOG 或升级指南中查找迁移方案。第二步调用方自身被弃用时豁免一个重要的例外规则如果调用被弃用类的代码本身也处于弃用迁移过程中即调用方自身已被标记为deprecated则不会报告此错误。/** deprecated */ function createLogger(): object { return new OldLogger(); }这在大型代码库的渐进式迁移中非常实用先标记仍然保留旧行为的桥接函数为deprecated让依赖它的更高层代码不再报警同时保留清晰的迁移线索待时机成熟后统一删除。第三步纳入 CI 与升级流程要让这类错误真正发挥约束作用推荐做法是在composer.json的require-dev中加入扩展PHPStan 2.0 的对应版本要求见 UPGRADING.mdrequire-dev: { phpstan/phpstan: ^2.0, phpstan/phpstan-deprecation-rules: ^2.0 }在phpstan.neon中确认扩展已启用将分析结果接入 CI让new.deprecatedClass等弃用错误成为合并请求的硬性门槛在从 PHPStan 1.x 升级到 2.0 之前按 UPGRADING.md 的建议先启用 Bleeding Edge 并解决全部弃用告警确保升级路径顺畅。深入源码规则的实际工作方式从注册表 errorsIdentifiers.json 可知new.deprecatedClass由PHPStan\Rules\Deprecations\RestrictedDeprecatedClassNameUsageExtension产生。该规则类位于 phpstan-deprecation-rules 扩展包中对应源码 RestrictedDeprecatedClassNameUsageExtension.php是 PHPStan 动态扩展机制的一部分——PHPStan 2.x 允许通过扩展接口接管类名使用位置的检查逻辑。从源码结构可以推断其工作流程大致为当分析器遇到new ClassName()表达式时会向所有已注册的扩展分发一次类名使用事件RestrictedDeprecatedClassNameUsageExtension收到事件后通过反射或 PHPDoc 解析判断ClassName是否携带deprecated标签若命中则按使用位置此处为new选择对应的错误标识符new.deprecatedClass/new.deprecatedEnum/new.deprecatedInterface/new.deprecatedTrait并生成错误。这与注册表中同一规则类对应多个new.deprecated*标识符的事实完全吻合。值得一提的是e2e 集成测试目录如 e2e/integration 下的各 composer.lock将 phpstan-deprecation-rules 列为^2.0/2.0.x依赖并实际运行分析验证了该规则在真实项目组合中的可用性CLAUDE.md 中也记录了 PHPStan 使用 Claude 结合规则源码与测试夹具来生成这些错误文档的流程CLAUDE.md说明本标识符文档的结论与扩展源码、测试夹具保持了一致。常见问题Q1我没有安装 phpstan-deprecation-rules为什么还会看到 deprecated 相关错误因为 PHPStan 核心与部分第三方库自身也内置了少量弃用检测如对 PHP 内置函数的弃用提示。但new.deprecatedClass这一具体标识符只属于 phpstan-deprecation-rules 扩展。Q2能否忽略这类错误可以。该标识符ignorable: trueCLAUDE.md可通过 PHPStan 配置的ignoreErrors按 identifier 定向忽略。但建议仅在过渡期使用长期忽略会失去弃用迁移的提醒价值。Q3枚举、接口、trait 被弃用后用new也会报错吗接口与 trait 本身不可实例化因此实际场景中new.deprecatedInterface/new.deprecatedTrait更多是规则对异常代码的兜底检测new.deprecatedEnum则针对被弃用的枚举实例。它们与new.deprecatedClass共用同一规则类修复思路一致。Q4如何批量发现项目里所有此类问题运行分析时加上--error-formatjson或在 CI 中使用支持 identifier 的输出格式即可按new.deprecatedClass过滤出全部命中点便于集中安排迁移。结语new.deprecatedClass是 phpstan-deprecation-rules 扩展针对实例化被弃用类场景给出的精确告警。掌握它等于掌握了 PHP 弃用迁移中最常见的一类静态分析信号理解触发条件、遵循替换替代品、必要时标记调用方为弃用的修复路径并把它接入 CI 与升级流程就能在库升级前系统性地清除技术债。配合attribute.deprecatedClass、class.extendsDeprecatedClass等同族标识符PHPStan 为你的代码现代化提供了从发现弃用到验证清零的完整闭环。赞分享开发工具代码质量静态分析【免费下载链接】phpstanPHP Static Analysis Tool - discover bugs in your code without running it!项目地址https://gitcode.com/gh_mirrors/ph/phpstan点击查看免费下载相关推荐PHPStan 错误标识符 class.extendsDeprecatedTrait 详解类 extends 已废弃 Trait 的检测与修复PHPStan 错误标识符 class.extendsDeprecatedTrait 详解类 extends 已废弃 Trait 的检测与修复 导读 clas开发工具代码质量静态分析PHPStan 错误标识符解析assert.deprecatedEnum —— phpstan-assert 引用已废弃枚举的检测与修复PHPStan 错误标识符解析 assert.deprecatedEnum —— phpstan assert 引用已废弃枚举的检测与修复 导读 asser开发工具代码质量静态分析PHPStan 错误标识符 classConstant.deprecatedTrait在已废弃 Trait 上访问类常量的检测与修复PHPStan 错误标识符 classConstant.deprecatedTrait在已废弃 Trait 上访问类常量的检测与修复 在 PHP 项目中Tr开发工具代码质量静态分析创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 PHPStan 错误标识符 new.deprecatedClass 全面解析：实例化已废弃类的检测规则与修复实践
开发工具代码质量静态分析【免费下载链接】phpstanPHP Static Analysis Tool - discover bugs in your code without running it!项目地址https://gitcode.com/gh_mirrors/ph/phpstan点击查看免费下载PHPStan 在分析new ClassName()语句时会通过new.deprecatedClass错误标识符报告对已被deprecated标记的类的实例化行为。本文以 PHPStan 官方错误文档为骨架结合仓库中的标识符注册表与扩展安装指引系统讲解该错误的触发机制、与 phpstan-deprecation-rules 扩展的关系、常见修复路径以及同一规则族new.deprecatedEnum/new.deprecatedInterface/new.deprecatedTrait在代码现代化迁移中的实战价值。读完本文你将能识别、复现并消除此类弃用警告为升级到 PHPStan 2.0 及后续大版本扫清障碍。错误标识符是什么PHPStan 的机器可读错误 IDPHPStan 的每一条分析错误都带有一个稳定的、机器可读的错误标识符error identifier格式通常为命名空间.规则名。它让开发者、CI 工具和 IDE 能够精确地区分不同类型的错误并在配置文件中针对性地处理例如通过reportUnmatchedIgnoredErrors追踪忽略项、或按 identifier 定向忽略。new.deprecatedClass便是其中一员。从仓库的标识符注册表 errorsIdentifiers.json 可以看到该标识符由PHPStan\Rules\Deprecations\RestrictedDeprecatedClassNameUsageExtension规则类产生归属phpstan/phpstan-deprecation-rules扩展包注册表条目。该规则同时负责new.deprecatedEnum、new.deprecatedInterface、new.deprecatedTrait等同族标识符并指定了扩展包源码 RestrictedDeprecatedClassNameUsageExtension.php 作为实现参考。错误标识符文档的统一规范见 website/errors/CLAUDE.md每份文档由title、shortDescription、ignorable三段 frontmatter 与Code example / Why is it reported? / How to fix it三节正文构成。其中ignorable: true表明该错误允许通过ignoreErrors配置被忽略前缀new对应 PHP 语言中的new ClassName()实例化表达式见 CLAUDE.md 中的 标识符前缀参考表。触发场景一段最小化复现代码以下代码即可稳定触发new.deprecatedClass?php declare(strict_types 1); /** deprecated Use NewLogger instead */ class OldLogger { } new OldLogger();两个关键要素缺一不可类被deprecated标记PHPDoc 注释中的deprecated标签是 PHPStan以及大多数静态分析工具识别弃用信息的标准途径可附带推荐替代品的说明例如本例中的Use NewLogger instead用new实例化该被弃用的类new OldLogger()是整条规则的检查对象。只要以上条件成立PHPStan 就会在分析结果中输出一条携带new.deprecatedClass标识符的错误。为什么会被报告扩展规则与弃用语义规则来自 phpstan-deprecation-rules 扩展而非 PHPStan 核心new.deprecatedClass并非 PHPStan 核心内置规则而是由官方扩展包 phpstan-deprecation-rules 中该扩展被列为 PHPStan 生态中负责弃用检测Deprecation detection的组件UPGRADING.md 在 PHPStan 2.0 升级指南中也明确要求用户安装并启用 phpstan-deprecation-rules。若未安装该扩展上述代码不会报出此错误。这也是理解该标识符的第一原则它的出现以扩展启用为前提。语言层面的弃用语义从 PHP 语言视角看deprecated是一个约定俗成的 PHPDoc 约定标记某个类不再推荐使用可能在未来的版本中被移除。它本身不会触发 PHP 运行时的任何行为——类仍然可以正常new、正常调用。因此使用被弃用的类不会导致程序崩溃但会让新代码建立在即将被移除的实现之上形成技术债在库/框架升级时造成连锁弃用——你依赖的类被删除后调用方必须同步改造掩盖真正值得关注的架构演进方向文档给出的弃用原因通常指明了推荐替代品。new.deprecatedClass的价值正在于把这种沉默的隐患提前暴露在 CI 阶段而非等到运行时或升级时才暴露。规则族与触发面的全覆盖同类规则还覆盖了其他使用被弃用类名的场景例如attribute.deprecatedClass属性attribute引用了被弃用的类attribute.deprecatedClass.mdassert.deprecatedClassphpstan-assert断言引用了被弃用的类assert.deprecatedClass.mdclass.extendsDeprecatedClass继承自被弃用的类class.extendsDeprecatedClass.mdnew.deprecatedEnum/new.deprecatedInterface/new.deprecatedTraitnew被弃用的枚举、接口或 trait。这些标识符共同构成 phpstan-deprecation-rules 对类名使用位置ClassNameUsageLocation的完整审计网络——凡是在继承、实现、实例化、属性、断言、捕获、方法调用等位置出现被弃用的类名都会得到对应标识符的错误提示。如何修复三步替换法第一步替换为推荐的替代类修复的核心动作是把被弃用的类替换为deprecated注释中推荐的替代品-new OldLogger(); new NewLogger();如果原类没有在deprecated注释中指明替代品需要到该类所在的库文档、CHANGELOG 或升级指南中查找迁移方案。第二步调用方自身被弃用时豁免一个重要的例外规则如果调用被弃用类的代码本身也处于弃用迁移过程中即调用方自身已被标记为deprecated则不会报告此错误。/** deprecated */ function createLogger(): object { return new OldLogger(); }这在大型代码库的渐进式迁移中非常实用先标记仍然保留旧行为的桥接函数为deprecated让依赖它的更高层代码不再报警同时保留清晰的迁移线索待时机成熟后统一删除。第三步纳入 CI 与升级流程要让这类错误真正发挥约束作用推荐做法是在composer.json的require-dev中加入扩展PHPStan 2.0 的对应版本要求见 UPGRADING.mdrequire-dev: { phpstan/phpstan: ^2.0, phpstan/phpstan-deprecation-rules: ^2.0 }在phpstan.neon中确认扩展已启用将分析结果接入 CI让new.deprecatedClass等弃用错误成为合并请求的硬性门槛在从 PHPStan 1.x 升级到 2.0 之前按 UPGRADING.md 的建议先启用 Bleeding Edge 并解决全部弃用告警确保升级路径顺畅。深入源码规则的实际工作方式从注册表 errorsIdentifiers.json 可知new.deprecatedClass由PHPStan\Rules\Deprecations\RestrictedDeprecatedClassNameUsageExtension产生。该规则类位于 phpstan-deprecation-rules 扩展包中对应源码 RestrictedDeprecatedClassNameUsageExtension.php是 PHPStan 动态扩展机制的一部分——PHPStan 2.x 允许通过扩展接口接管类名使用位置的检查逻辑。从源码结构可以推断其工作流程大致为当分析器遇到new ClassName()表达式时会向所有已注册的扩展分发一次类名使用事件RestrictedDeprecatedClassNameUsageExtension收到事件后通过反射或 PHPDoc 解析判断ClassName是否携带deprecated标签若命中则按使用位置此处为new选择对应的错误标识符new.deprecatedClass/new.deprecatedEnum/new.deprecatedInterface/new.deprecatedTrait并生成错误。这与注册表中同一规则类对应多个new.deprecated*标识符的事实完全吻合。值得一提的是e2e 集成测试目录如 e2e/integration 下的各 composer.lock将 phpstan-deprecation-rules 列为^2.0/2.0.x依赖并实际运行分析验证了该规则在真实项目组合中的可用性CLAUDE.md 中也记录了 PHPStan 使用 Claude 结合规则源码与测试夹具来生成这些错误文档的流程CLAUDE.md说明本标识符文档的结论与扩展源码、测试夹具保持了一致。常见问题Q1我没有安装 phpstan-deprecation-rules为什么还会看到 deprecated 相关错误因为 PHPStan 核心与部分第三方库自身也内置了少量弃用检测如对 PHP 内置函数的弃用提示。但new.deprecatedClass这一具体标识符只属于 phpstan-deprecation-rules 扩展。Q2能否忽略这类错误可以。该标识符ignorable: trueCLAUDE.md可通过 PHPStan 配置的ignoreErrors按 identifier 定向忽略。但建议仅在过渡期使用长期忽略会失去弃用迁移的提醒价值。Q3枚举、接口、trait 被弃用后用new也会报错吗接口与 trait 本身不可实例化因此实际场景中new.deprecatedInterface/new.deprecatedTrait更多是规则对异常代码的兜底检测new.deprecatedEnum则针对被弃用的枚举实例。它们与new.deprecatedClass共用同一规则类修复思路一致。Q4如何批量发现项目里所有此类问题运行分析时加上--error-formatjson或在 CI 中使用支持 identifier 的输出格式即可按new.deprecatedClass过滤出全部命中点便于集中安排迁移。结语new.deprecatedClass是 phpstan-deprecation-rules 扩展针对实例化被弃用类场景给出的精确告警。掌握它等于掌握了 PHP 弃用迁移中最常见的一类静态分析信号理解触发条件、遵循替换替代品、必要时标记调用方为弃用的修复路径并把它接入 CI 与升级流程就能在库升级前系统性地清除技术债。配合attribute.deprecatedClass、class.extendsDeprecatedClass等同族标识符PHPStan 为你的代码现代化提供了从发现弃用到验证清零的完整闭环。赞分享开发工具代码质量静态分析【免费下载链接】phpstanPHP Static Analysis Tool - discover bugs in your code without running it!项目地址https://gitcode.com/gh_mirrors/ph/phpstan点击查看免费下载相关推荐PHPStan 错误标识符 class.extendsDeprecatedTrait 详解类 extends 已废弃 Trait 的检测与修复PHPStan 错误标识符 class.extendsDeprecatedTrait 详解类 extends 已废弃 Trait 的检测与修复 导读 clas开发工具代码质量静态分析PHPStan 错误标识符解析assert.deprecatedEnum —— phpstan-assert 引用已废弃枚举的检测与修复PHPStan 错误标识符解析 assert.deprecatedEnum —— phpstan assert 引用已废弃枚举的检测与修复 导读 asser开发工具代码质量静态分析PHPStan 错误标识符 classConstant.deprecatedTrait在已废弃 Trait 上访问类常量的检测与修复PHPStan 错误标识符 classConstant.deprecatedTrait在已废弃 Trait 上访问类常量的检测与修复 在 PHP 项目中Tr开发工具代码质量静态分析创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考