PhpStorm 2026.2 Help

PHPStan

在此页面启用并配置 PHPStan 质量工具。

项目

描述

配置

从列表中选择所需的解释器。 该列表包含所有当前配置的本地和远程 PHP 解释器。 如需更多信息,请参阅 配置本地 PHP 解释器配置远程 PHP 解释器

单击下拉列表右侧的 “浏览”按钮 打开 PHPStan 对话框

显示被忽略的文件

单击以打开 PHPStan 忽略的文件 对话框,其中列出了 PHPStan 跳过的文件。 PhpStorm 建议在检查期间,当等待 PHPStan 的响应超过 工具进程超时 字段中指定的限制时,将新文件添加到列表中。 这样做是为了防止处理速度变慢。 对于每个文件,PhpStorm 会显示其名称和位置。

  • 要添加文件,请单击 "添加"按钮 并在打开的对话框中找到所需的文件。

  • 要从列表中删除文件并让 PHPStan 再次处理它,请选择该文件并单击 移除文件 按钮 "移除"按钮

  • 要从列表中删除所有文件,请单击 关闭按钮

完整项目运行(仅限批处理模式)

使用该选项选择是否在检查运行范围中包含整个项目或仅包含其 源根目录

编辑器模式(需要 PHPStan 1.12.27+ / 2.1.17+)

选中复选框后,PhpStorm 会使用 --tmp-file--instead-of CLI 选项运行 PHPStan 检查,将正在编辑的项目文件替换为临时文件版本。

有关 PHPStan 编辑器模式的更多信息,请参阅 PHPStan 文档

级别

提供所需的 规则级别 ,以便 PHPStan 执行检查。 请注意,如果提供了配置文件,PhpStorm 将依赖于该文件中指定的 级别 值,并忽略 级别 字段。

配置文件

提供 PHPStan 配置文件 的路径。

自动加载文件

提供自动加载器的路径。 请注意,如果提供了配置文件,PhpStorm 将依赖于该文件中指定的 autoload-file 值,并忽略 自动加载文件 字段。

内存限制

提供 PHPStan 允许分配的最大 RAM 量。 您可以提供以字节为单位的明确整数值,或使用 简写表示法500M4G 等)。

运行模式

配置 PHPStan 触发代码分析的频率:

  • 随时随地 – PHPStan 会自动在后台运行。 在输入时,问题会在编辑器中被高亮显示。

  • 空闲时 – 当停止输入并且 空闲阈值(毫秒): 字段中指定的空闲时间过去后,PHPStan 才会运行。

  • 在保存时 – 只有在手动保存文件或通过 PhpStorm 的自动保存时,才会触发 PHPStan。 只有当文件状态持久化到磁盘时,问题高亮显示才会更新。

空闲阈值(毫秒):

定义在代码修改后 PHPStan 运行前的延迟时间(毫秒)。

最小间隔(毫秒):

定义在同一文件上两次连续运行 PHPStan 之间必须经过的最短时间(毫秒)。 这样可以防止在频繁保存文件或大量输入时 PHPStan 运行过于频繁。

PHPStan 对话框

单击 “浏览”按钮 ,打开 配置 列表旁边的 PHPStan 页面上的对话框。

使用此对话框配置所用的 PHP 解释器、PHPStan 可执行文件的路径以及 PHPStan 的行为。 有关更多信息,请参见 PHPStan

项目

描述

解释器窗格

对话框的左侧窗格显示用于 PHPStan 的默认 PHP 解释器。 要添加不同的解释器,请单击 "添加"按钮 并从项目中配置的 CLI 解释器 列表中选择一个项目。

PHPStan 路径

在此字段中,指定 PHPStan 脚本的位置:Windows 使用 phpstan.bat ,Linux 和 macOS 使用 phpstan

PhpStorm 会检测 vendor/bin 文件夹中 PHPStan 可执行文件的路径,并自动填写字段,但您可以根据需要进行编辑。 请手动输入路径或点击 “浏览”按钮 并在打开的对话框中选择路径。

要检查指定的 phpstan.bat phpstan 路径是否确保 PhpStorm 与 PHPStan 之间的交互,即工具可以从 PhpStorm 启动并且 PhpStorm 会接收其问题报告,请单击 验证 按钮。 此验证等同于运行 phpstan --version 命令。 如果验证成功,PhpStorm 会显示检测到的 PHPStan 版本信息。

工具进程超时

在此字段中,指定您希望 PhpStorm 等待 PHPStan 返回结果的时间。 如果超时,进程将被终止以防止过多的 CPU 和内存使用。 这使您可以根据计算机的配置和使用的规则集微调 PHPStan 的处理行为。

2026年 7月 16日