推荐使用 PHPStan Deprecation Rules：智能检测废弃代码的利器

在软件开发过程中，随着功能迭代和优化，旧有的类、方法、属性和常量等有时会被标记为@deprecated，以提示开发者不应再继续使用。然而手动查找这些废弃代码是耗时且容易遗漏的。这就是PHPStan Deprecation Rules的用武之地，它是一个强大的PHP静态分析工具扩展，专用于检测并报告废弃代码的使用。

项目介绍

PHPStan Deprecation Rules 是 PHPStan 的一个插件，旨在帮助开发人员自动发现和修复项目中已废弃的代码片段。通过集成到您的构建流程，它可以确保你的代码库始终遵循最佳实践，并保持最新的状态。

项目技术分析

该扩展工作原理是扫描项目中的代码，检测那些被@deprecated注解的类、方法、属性和常量的使用情况。它不仅适用于您自己的代码，还可以检查第三方库，这是通过读取其文档注释实现的。此外，如果你有特定的废弃代码标记方式，可以自定义DeprecatedScopeResolver来扩展其功能。

项目及技术应用场景

无论你是维护大型企业级应用，还是小型个人项目，PHPStan Deprecation Rules 都能成为你的得力助手。当你：

• 升级依赖库，想要确保新版本中已废弃的代码已被替换。
• 进行代码审计，保证代码质量与最佳实践同步。
• 想要减少维护负担，避免遗留"遗留代码"。

PHPStan Deprecation Rules 都能在这些场景下提供巨大的价值。

项目特点

1. 自动化检测：节省人工查找废弃代码的时间，提高效率。
2. 兼容第三方库：不仅仅局限于自身的代码，也能对引入的库进行检测。
3. 高度可扩展性：允许自定义规则，适应不同项目的特殊需求。
4. 简单集成：通过 Composer 安装后，只需一步即可轻松配置到现有 PHPStan 设置中。
5. 智能排除：默认忽略自身标记为@deprecated的代码，防止误报。

使用步骤

1. 使用 composer require --dev phpstan/phpstan-deprecation-rules 添加依赖。
2. 如需自动加载扩展，安装 phpstan/extension-installer。
3. 或者，手动在 rules.neon 文件中包含扩展配置。
4. 自定义 DeprecatedScopeResolver 以处理特殊情况。

立即使用 PHPStan Deprecation Rules，让废弃代码无处遁形，提升你的代码质量，迈向更加健壮和可持续的项目架构。