质量工具

配置

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

单击下拉列表右侧的 打开 PHP_CodeSniffer 对话框。

显示忽略的文件

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

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

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

• 要从列表中删除所有文件，请单击 。

检查带扩展名的文件

提供一个以逗号分隔的文件扩展名列表，这些扩展名应由 PHP_CodeSniffer 检查。

将警告显示为...

要让 PHP_CodeSniffer 除了报告错误外还报告警告，请选中复选框并从列表中选择 严重程度。 清除复选框以仅报告错误并抑制警告报告。

显示sniff 名称

选中复选框以在编辑器或 检查结果 中显示相应的 sniff 名称，以及检查摘要。

已安装的标准路径

如果您依赖于自定义的第三方编码标准（例如， Coder 或 Joomla Coding Standards ），则需要在使用 PHP_CodeSniffer 之前将其集成。 为此，请选中 已安装的标准路径 复选框，单击 并在打开的对话框中选择自定义标准的安装目录。

编码标准

指定要应用的编码标准。

• 要使用预定义的 编码标准 ，请在 编码标准 列表中选择它，并指定要检查代码的编码样式。 列表包含安装在主 php_codesniffer 目录结构中的所有编码标准。

• 要根据 您自己先前定义的编码标准 检查代码，请从列表中选择 自定义 ，并提供包含您自己编码标准的 ruleset.xml 文件的路径。 手动输入路径或单击 并在打开的对话框中选择相关文件夹。

配置

从列表中选择所需的解释器。 该列表包含所有当前配置的本地和远程 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 解释器。 如需更多信息，请参阅 配置本地 PHP 解释器 和 配置远程 PHP 解释器。

单击下拉列表右侧的 打开 Laravel Pint 对话框。

显示被忽略的文件

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

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

• 要从列表中删除文件并让 Laravel Pint 再次处理它，请选择该文件并单击 移除文件 按钮 。

• 要从列表中删除所有文件，请单击 。

仅重新格式化未提交的文件

选中复选框以仅修改具有未提交更改的文件。

pint.json 的路径

指定您自己的 pint.json 配置文件的路径。 pint.json 文件是可选的：它们用于启用/禁用预定义 Laravel Pint 预设中的特定规则，或重用来自 PHP CS Fixer 的自定义规则集。

规则集

选择 Laravel Pint 的一个 预定义规则组。

配置

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

单击下拉列表右侧的 打开 Mess Detector 对话框。

显示忽略的文件

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

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

• 要从列表中删除文件并让 Mess Detector 再次处理它，请选择该文件并单击 移除文件 按钮 。

• 要从列表中删除所有文件，请单击 。

选项

• 要使用 预定义规则 ，请在 选项 区域中选中要执行的验证旁边的复选框。

• 要使用自定义规则集：

  1. 创建并保存一个或多个 规则集文件。 有效的 规则集文件 是一个包含 <ruleset> 根元素和 name 属性的 .xml 文件。 有关 自定义规则集 的更多信息，请参阅 http://phpmd.org/documentation/creating-a-ruleset.html。

  2. 在 自定义规则集 区域中，单击 并在打开的对话框中选择相关规则定义文件。 当您单击 确定 时，会向 自定义规则集 列表中添加一个新项目，其中 名称 字段显示从 <ruleset> 标签内的 name 属性中检索到的规则集名称， File 字段显示所选规则集文件的位置。

配置

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

单击下拉列表右侧的 打开 Psalm 对话框。

显示忽略的文件

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

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

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

• 要从列表中删除所有文件，请单击 。

配置文件

提供 Psalm 配置文件 的路径。 如果文件不存在，PhpStorm 会显示通知，提示您创建它。

显示信息(S)

选中复选框以让 Psalm 报告低于配置文件中指定的 errorLevel 的错误。 如果未选中复选框，则会忽略此类错误。

查找未使用的代码(F)

选中复选框以让 Psalm 报告定位到的未使用代码（包括未使用的变量）。

查找未使用的@psalm-suppress 注解

选中复选框以让 Psalm 报告所有未使用的 @psalm-suppress 注解。

配置

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

单击下拉列表右侧的 打开 PHPStan 对话框。

显示忽略的文件

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

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

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

• 要从列表中删除所有文件，请单击 。

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

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

级别

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

配置文件

提供 PHPStan 配置文件 的路径。

自动加载文件

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

内存限制

提供 PHPStan 允许分配的最大 RAM 量。 您可以提供以字节为单位的明确整数值，或使用 简写表示法 （500M、 4G 等）。

外部格式化工具

以下代码质量工具可用作外部格式化器：

• PHP Code Beautifier and Fixer ：选择此项，如果在 PHP_CodeSniffer 部分中配置了 PHP_CodeSniffer 和 PHP Code Beautifier and Fixer 工具。

• PHP CS Fixer ：选择此项，如果在 PHP CS Fixer 部分中配置了 PHP CS Fixer 工具。

• Laravel Pint ：选择此项，如果在 Laravel Pint 部分中配置了 Laravel Pint 工具。

• 无外部格式化程序 ：选择此项以使用 PhpStorm 内置的代码格式化规则。 当配置了多个或未配置代码质量工具时的默认选项。