PHPStan：通过静态分析提高 PHP 代码质量

在动态类型盛行的 PHP 生态系统中，管理代码质量并确保无错误开发可能具有挑战性。 PHPStan 是一款专为 PHP 定制的静态分析工具，旨在帮助开发人员在运行代码之前捕获错误和潜在问题。通过静态分析，PHPStan 允许开发人员通过在开发早期捕获错误来编写更可靠、可维护和健壮的代码。在这篇文章中，我们将探讨 PHPStan 是什么、谁应该使用它、如何将其合并到您的开发工作流程中，以及 PHPStan 2.0 中的一些令人兴奋的更新。

---

什么是 PHPStan？

PHPStan 是 PHP 的静态分析工具，可以检查代码并识别问题而不执行代码。与运行时测试不同，静态分析不需要您的代码运行，这使得 PHPStan 可以在您编写代码时实时发现问题和潜在的错误。这在 PHP 中特别有用，其中动态类型系统有时会导致问题在运行时才被注意到。

PHPStan 通过分析类型、变量、函数调用和其他代码模式来运行，以发现不一致或潜在的错误。它有助于识别错误，例如：

• 对可能为 null 的变量调用方法
• 访问未定义的属性
• 将错误的类型传递给函数
• 使用未定义的变量或类

虽然这些问题可能会在运行时被发现（如果被发现的话），但 PHPStan 在开发过程中会捕获它们，为开发人员创建更快的反馈循环，并生成更干净、更健壮的代码。

---

为什么使用 PHPStan？

使用 PHPStan 带来许多好处，包括：

1. 早期检测错误：PHPStan 可以帮助您在问题进入生产之前识别问题，防止可能影响应用程序可靠性和性能的运行时错误。
2. 提高代码质量：通过执行更严格的类型检查和编码实践，PHPStan 可以生成更易于维护、可读的代码。
3. 对重构的信心：当您有像 PHPStan 这样的工具来验证您的更改，确保您不会引入新问题时，重构代码就会变得不那么令人生畏。
4. 跨团队的一致性：PHPStan 强制执行编码标准和最佳实践，这可以帮助团队创建更一致的代码库，尤其是在协作环境中。

---

谁应该使用 PHPStan？

PHPStan 对于各个级别的 PHP 开发人员来说都是一个很棒的工具。然而，它对于以下方面特别有价值：

• 中高级 PHP 开发人员：更有经验的开发人员会欣赏 PHPStan 提供的额外级别的完善和控制，特别是对于大型代码库。
• 团队和组织：PHPStan 帮助团队实施一致的编码实践，使多个开发人员更容易协作并理解彼此的工作。
• 开源项目：对于开源维护者来说，PHPStan 可以帮助在贡献中保持较高的代码质量标准，确保新代码不会引入问题。
• 具有遗留代码的项目：PHPStan 可以逐步帮助清理和现代化遗留代码库，捕获过时或有问题的模式并确保它们遵循当前的最佳实践。

虽然 PHPStan 有一个学习曲线，并且最初可能感觉很严格，但它通过提高任何 PHP 项目的质量和可维护性而很快得到回报。

---

如何使用 PHPStan

PHPStan 在项目中设置和开始使用相对简单。以下是快速入门指南：

1. 安装 PHPStan： 您可以通过 PHP 依赖管理器 Composer 安装 PHPStan：

   composer require --dev phpstan/phpstan

1. 配置 PHPStan:
   可以使用 phpstan.neon 或 phpstan.neon.dist 文件配置 PHPStan，您可以在其中指定分析设置、级别和规则。配置文件允许自定义以满足您的项目需求，包括分析路径以及忽略规则和扩展。

2. 设置分析级别:
   PHPStan 提供不同的分析级别（从 0 到 8），其中 0 是最不严格的，8 是最严格的。通常建议从较低级别开始，并随着代码库的改进逐渐增加。
   

   phpstan analyse --level max src

1. 运行 PHPStan： 要分析您的代码库，只需运行：

   phpstan analyse src

PHPStan 将输出警告和错误以及在代码中找到它们的上下文，允许您在继续之前解决它们。

1. 与 CI/CD 集成： PHPStan 可以添加到您的 CI/CD 管道中，以确保代码质量检查自动化。许多 CI 服务，例如 GitHub Actions、GitLab CI 和 Travis CI，都提供了轻松集成 PHPStan 的选项。

通过让 PHPStan 成为您的开发和审核流程的一部分，您可以减少出现错误的可能性，提高代码质量，并增强对 PHP 代码的信心。

---

关于 Laravel 项目

1：如果您正在开发 Laravel 项目，则可以利用 larastan 软件包，该软件包专为 Laravel 应用程序量身定制，并提供特定于 Laravel 的附加功能和检查。要安装 larastan，请运行：

   composer require --dev phpstan/phpstan

2：然后，在应用程序的根目录中创建 phpstan.neon 或 phpstan.neon.dist 文件。它可能看起来像这样：

   phpstan analyse --level max src

有关所有可用选项，请查看 PHPStan 文档：https://phpstan.org/config-reference

3：最后，您可以使用 phpstan 控制台命令开始分析代码：

如果您收到错误“允许的内存大小耗尽”，那么您可以使用 --memory-limit 选项解决问题：

   phpstan analyse src

忽略错误

忽略特定错误可以通过 php 注释或配置文件来完成：

composer require --dev "larastan/larastan:^2.0"

忽略 PHPStan 配置文件中的错误时，通过根据错误消息编写正则表达式来忽略它们：

includes:
    - vendor/larastan/larastan/extension.neon

parameters:

    paths:
        - app/

    # Level 9 is the highest level
    level: 5

#    ignoreErrors:
#        - '#PHPDoc tag @var#'
#
#    excludePaths:
#        - ./*/*/FileToBeExcluded.php
#
#    checkMissingIterableValueType: false

基线文件
在较旧的代码库中，可能很难花时间修复所有代码以通过高 PHPStan 级别。

为了解决这个问题，可以生成一个基线文件。基线文件将创建一个包含所有当前错误的配置文件，因此可以按照比旧代码更高的标准编写新代码。 （PHPStan 文档）

./vendor/bin/phpstan analyse --memory-limit=2G

PHPStan 2.0 有什么新功能？

在 PHPStan 2.0 中，该工具引入了多项强大的新功能，增强了其功能并使其对开发人员更加有效。

1. 增强的类型推断：PHPStan 2.0 提供改进的类型推断，这意味着它可以更准确地理解代码中的复杂类型关系。这样可以更好地检测问题并进行更可靠的分析。

2. 对泛型的支持：PHPStan 2.0 显着增强了对 PHP 中泛型的支持，为泛型代码模式提供了更准确的类型检查，尤其是在框架和库中。此更新允许使用更少的样板代码实现更清晰的代码，从而更轻松地编写通用类和函数。

3. 更好地处理遗留代码：PHPStan 2.0 已经过优化，可以更有效地分析遗留代码库，帮助开发人员实现旧项目的现代化，而不会让他们因错误而不堪重负。

4. 性能提高：最新版本的 PHPStan 速度更快，使其能够更有效地分析更大的代码库，这在速度至关重要的 CI/CD 环境中特别有益。

5. 新规则自定义：使用 PHPStan 2.0，开发人员可以更好地控制执行哪些规则和检查。这对于具有特定编码标准或偏好的团队特别有用。

PHPStan 2.0 代表了 PHP 静态分析的重大飞跃，提供了更深入的洞察、更大的灵活性和更好的性能，以简化代码质量工作。

---

最大化 PHPStan 影响力的技巧

要充分利用 PHPStan，请考虑以下提示：

• 慢慢开始：在较低的分析级别引入PHPStan，并随着团队变得更加舒适而逐渐增加。
• 使用基线文件：PHPStan 允许您创建现有错误的基线以专注于新问题。这在遗留代码库中特别有用，因为一次性解决所有问题可能不可行。
• 投资自定义规则：如果您的项目有特定的编码标准，请考虑为 PHPStan 编写自定义规则。这可以帮助强化特定于项目的约定并保持一致性。
• 拥抱类型提示：您在代码中使用的类型提示越多，PHPStan 就能更好地分析它。鼓励在整个项目中对变量、参数和返回类型进行类型提示。

---

结论

PHPStan 改变了 PHP 开发人员的静态分析，带来了一组强大的工具来在开发过程的早期识别和解决问题。随着 PHPStan 2.0 的发布，它比以往任何时候都更强大，拥有增强的类型推断、对泛型的更好支持以及性能改进，使其成为现代 PHP 开发的重要工具。

通过将 PHPStan 集成到您的开发工作流程中，您可以投资于代码质量、减少错误，并最终创建更可靠和可维护的代码库。无论您是从事大型协作项目还是只是想改进个人项目，PHPStan 都是每个 PHP 开发人员都应该考虑的宝贵资产。

以上是PHPStan：通过静态分析提高 PHP 代码质量的详细内容。更多信息请关注PHP中文网其他相关文章！