PhpStorm 2026.2 Help

PHP CS Fixer

在此页面启用并配置 PHP CS Fixer 质量工具。

项目

描述

配置

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

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

显示被忽略的文件

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

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

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

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

为内置规则集允许风险规则。

选中复选框以允许 高风险规则 ,即可能更改代码行为的规则。 默认情况下,不允许高风险规则。

规则集

指定要应用的规则集。

  • 要使用预定义的 规则集 ,请从下拉列表中选择它。 列表包含声明在主 php-cs-fixer 目录结构中的所有规则集。

  • 要根据 您自己先前定义的规则集 检查代码,请从列表中选择 自定义 ,并提供包含此规则集的 .php_cs .php_cs.dist 文件的路径。 手动输入路径或单击 “浏览”按钮 并在打开的对话框中选择相关文件夹。

运行模式

配置 PHP CS Fixer 触发代码分析的频率:

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

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

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

空闲阈值(毫秒):

定义在代码修改后 PHP CS Fixer 运行前的延迟时间(以毫秒为单位)。

最小间隔(毫秒):

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

PHP CS Fixer 对话框

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

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

项目

描述

解释器窗格

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

PHP CS Fixer 路径

在此字段中,指定 PHP CS Fixer 脚本的位置:Windows 使用 php-cs-fixer.bat ,Linux 和 macOS 使用 php-cs-fixer

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

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

工具进程超时

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

2026年 7月 16日