PHPStan：通过静态分析提高 PHP 代码质量-php教程-PHP中文网

PHPStan: Elevate Your PHP Code Quality with Static Analysis

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

什么是 PHPStan？

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

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

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

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

为什么使用 PHPStan？

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

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

谁应该使用 PHPStan？

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

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

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

如何使用 PHPStan

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

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

   composer require --dev phpstan/phpstan

登录后复制

配置 PHPStan:
可以使用 phpstan.neon 或 phpstan.neon.dist 文件配置 PHPStan，您可以在其中指定分析设置、级别和规则。配置文件允许自定义以满足您的项目需求，包括分析路径以及忽略规则和扩展。
设置分析级别:
PHPStan 提供不同的分析级别（从 0 到 8），其中 0 是最不严格的，8 是最严格的。通常建议从较低级别开始，并随着代码库的改进逐渐增加。

   phpstan analyse --level max src

登录后复制

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

   phpstan analyse src

登录后复制

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

与 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 中，该工具引入了多项强大的新功能，增强了其功能并使其对开发人员更加有效。

增强的类型推断：PHPStan 2.0 提供改进的类型推断，这意味着它可以更准确地理解代码中的复杂类型关系。这样可以更好地检测问题并进行更可靠的分析。
对泛型的支持：PHPStan 2.0 显着增强了对 PHP 中泛型的支持，为泛型代码模式提供了更准确的类型检查，尤其是在框架和库中。此更新允许使用更少的样板代码实现更清晰的代码，从而更轻松地编写通用类和函数。
更好地处理遗留代码：PHPStan 2.0 已经过优化，可以更有效地分析遗留代码库，帮助开发人员实现旧项目的现代化，而不会让他们因错误而不堪重负。
性能提高：最新版本的 PHPStan 速度更快，使其能够更有效地分析更大的代码库，这在速度至关重要的 CI/CD 环境中特别有益。
新规则自定义：使用 PHPStan 2.0，开发人员可以更好地控制执行哪些规则和检查。这对于具有特定编码标准或偏好的团队特别有用。

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