IntelliJ IDEA
 
2023.2
快捷方式：Windows
获取 IntelliJ IDEA
  1. 非 JVM 技术
  2. PHP
  3. PHP 参考

最终的
PHP 参考

最后修改时间：2023 年 10 月 27 日

文件| 设置 | 语言和框架 | 适用于 Windows 和 Linux 的PHP

IntelliJ IDEA | 设置 | 语言和框架 | 适用于 macOS 的PHP

CtrlAlt0S 设置图标

该页面及该节点下的所有页面只有在启用PHP插件后才可用。PHP插件未与 IntelliJ IDEA 捆绑在一起，但可以在“设置”|“设置”中安装。插件页面，选项卡Marketplace ，如从 JetBrains Marketplace 安装插件中所述。

使用此页面通过选择可用的 PHP 解释器之一来配置项目中的 PHP 开发和单元测试支持。

物品

工具提示/

捷径

描述

PHP语言级别

在此列表中，指定要获取编码帮助的 PHP 功能范围。每个功能范围都与支持该功能的 PHP 版本相关联。目前支持PHP 5.3、PHP 5.4、PHP 5.5、PHP 5.6、PHP 7、PHP 7.1、PHP 7.2、PHP 7.3、PHP 7.4、PHP 8.0、PHP 8.1和PHP 8.2级别。有关更多信息，请参阅支持的 PHP 版本。

项目中使用的 PHP 版本与 IntelliJ IDEA 中配置的 PHP 语言级别之间没有强制关联。尽管会自动检测每个解释器的语言版本，但您仍然可以告诉 IntelliJ IDEA 为您提供对应于不同语言级别的编码帮助。但是，如果您尝试使用指定语言级别不支持的代码构造，IntelliJ IDEA 建议切换到 PHP <version> 快速修复。

当您打开现有项目时，IntelliJ IDEA 会分析它所使用的语言功能并自动设置适当的语言级别。

提示

您还可以直接从状态栏设置 PHP 语言级别。

笔记

当 PHP 语言版本在Composer.json中受到限制并且在“设置”对话框 ( )的Composer页面上启用了与Composer.json的设置同步时，该列表处于非活动状态。CtrlAlt0S

CLI解释器

在此列表中，选择默认在当前项目中使用的 PHP 解释器。该列表包含所有当前配置的本地和远程 PHP 解释器。有关详细信息，请参阅 配置本地 PHP 解释器和配置远程 PHP 解释器。

浏览按钮

ShiftEnter

单击CLI 解释器列表旁边的此按钮，可在打开的CLI 解释器对话框中创建新的 IntelliJ IDEA 范围的 PHP 安装配置 。

有关详细信息，请参阅 配置本地 PHP 解释器和 配置远程 PHP 解释器。

路径映射

当您配置可通过 SFTP、Vagrant、Docker 或 WSL 访问的远程解释器时，此只读字段显示从相应的部署配置、Vagrantfile或Dockerfile检索的路径映射。这些映射是只读的。

要提供自定义映射，请单击浏览按钮字段旁边的 并在打开的“编辑项目路径映射”对话框中指定它们：

  • 要添加自定义映射，请单击并分别在“本地路径”和“远程路径”添加按钮字段中指定项目中的路径和远程运行环境上的相应路径。手动键入路径或单击并在打开的对话框中选择相关文件或文件夹。浏览按钮

  • 要删除自定义映射，请在列表中选择它并单击删除按钮。

笔记

无法为标记为排除的项目文件或文件夹设置路径映射 。

包括路径选项卡

该区域显示已配置的包含路径的列表。 包含路径用于保存库，即第三方代码，用于在某些使用文件路径作为参数的函数/方法中完成和引用解析，例如require()或include()。

  • 使用添加和消除添加和删除路径。

  • 使用提升和下移对列表中的项目重新排序。

  • 单击按字母顺序排序按钮可按字母升序对路径进行排序。

PHP 运行时选项卡

该区域列出了可用的PHP 存根，它们是正常的、语法正确的 PHP 文件，包含带注释的函数、方法和类签名、常量定义等。PHP 存根已添加到 IntelliJ IDEA 的内部知识中，以增强对所有标准 PHP 库组件以及常见扩展的编码帮助。

  • 使用每个项目旁边的复选框来启用/禁用相应的存根。

  • 要加载与当前配置的 CLI 解释器的已加载扩展集相匹配的存根集，请单击“与解释器同步扩展”按钮。有关配置解释器的更多信息，请参阅配置本地 PHP 解释器和 配置远程 PHP 解释器。

在“项目”工具窗口中，当前加载的存根显示在“外部库”节点下。

提示

PHP 存根是开源的，您可以为其开发做出贡献。有关更多信息，请参阅博客文章。

高级设置区域

如有必要，您可以加载一组自定义 PHP 存根以供 IntelliJ IDEA 使用。单击“默认存根路径”浏览按钮字段旁边的并在打开的对话框中提供存根文件夹位置。这样，您可以加载额外的 IntelliJ IDEA 存根以及覆盖捆绑的存根。

PHP 存根可作为Composer 包使用，因此可以作为某些第三方包的依赖项进行声明和安装。在这种情况下，它们存储在 项目内的供应商/jetbrains /phpstorm-stubs文件夹下。

要防止 Composer 包存根和 IntelliJ IDEA 捆绑存根之间发生冲突，请执行以下操作之一：

  • 要在项目中使用 Composer 包存根，请在默认存根路径字段中明确提供其位置的路径。

  • 要使用 IntelliJ IDEA 的捆绑 PHP 存根，请确保清除 默认存根路径字段，并从项目中排除供应商/jetbrains /phpstorm-stubs文件夹。

    • 如果在“语言和框架”|上启用“将包添加为库”选项 PHP | 设置对话框 ( ) 的Composer页面，IntelliJ IDEA 会自动将 供应商/jetbrains /phpstorm-stubs文件夹标记为已排除。默认情况下，该选项处于启用状态。CtrlAlt0S

    • 如果禁用“将包添加为库” ，您可以手动排除存根包文件夹。为此，在项目视图中，右键单击 供应商/jetbrains /phpstorm-stubs文件夹，然后选择将目录标记为 | 从上下文菜单中排除。

提示

有关使用 Composer 的更多信息，请参阅 Composer 依赖项管理器。

分析选项卡

使用此选项卡可配置某些 IntelliJ IDEA检查的行为。

异常分析

使用此部分来配置异常分析，这会更改未处理异常、冗余 catch 子句、缺少 @throws 标记和冗余 @throws 标记检查的行为。

物品

工具提示/

捷径

描述

调用树分析深度

使用此列表设置所需的异常分析深度级别。默认情况下，选择1，在这种情况下，IntelliJ IDEA 会报告抛出异常的父方法以及直接调用它的方法的未处理异常。选择较大的值可以让您更深入地了解调用层次结构。

如果选择0，则异常分析仅限于父方法。

笔记

大于1 的值可能会对 IDE 的性能产生负面影响。

跳过具有常量参数的调用

选中此复选框可使 IntelliJ IDEA 在异常分析期间跳过实例创建表达式中的某些方法调用：

  • 仅以字符串或常量作为参数的方法调用将被跳过：

    $date = new DateTime('2019-01-01');

  • 不会跳过以变量、整数、数组等作为参数的方法调用：

    $date = new DateTime($myDate);

未经检查的异常

使用此列表指定 IntelliJ IDEA 视为未检查的异常。在异常分析过程中会跳过此类异常。

添加班级

AltInsert

单击此按钮可将类添加到“未检查的异常”列表中。在打开的“选择类”对话框中，使用“按名称搜索”选项卡或“项目”选项卡找到所需的类。

删除按钮

Delete

单击此按钮可从“未检查的例外”列表中删除选定的类。

自定义格式函数

使用此部分将自定义字符串格式化函数包含到格式化函数参数不匹配检查分析范围中。此检查报告格式函数参数和规范转换条目之间的不匹配，并默认分析标准 PHP printf和sprintf函数的用法。

物品

工具提示/

捷径

描述

添加按钮

AltInsert

单击此按钮可将新函数记录添加到自定义格式函数列表中。在打开的“添加自定义格式函数”对话框中，提供类方法或函数的名称，并指定格式模板所在的参数索引。

删除按钮

Delete

单击此按钮可从自定义格式函数列表中删除函数记录。

编辑按钮

Enter

单击此按钮可以编辑所选的功能记录。

包括分析

使用此部分定义表达式应解析到的自定义文件夹，这会改变未解析的包含$_SERVER['DOCUMENT_ROOT']检查的行为。

指定的路径将用于使用文件路径作为参数的函数/方法的代码完成require()中（例如，或include()）。如果路径留空，代码完成将建议相对于项目根目录的路径。

通常，如果 Web 服务器配置定义的文档根文件夹与 IntelliJ IDEA 项目根文件夹不同，则应修改此设置。

物品

描述

$_SERVER['DOCUMENT_ROOT']

在此字段中，提供表达式$_SERVER['DOCUMENT_ROOT']应解析到的文件夹。

默认值为空：$_SERVER['DOCUMENT_ROOT']本例中的表达式解析为项目根文件夹。要使其解析为其他文件夹，请键入相对于项目根目录的所需文件夹路径，或者单击从磁盘打开并在打开的对话框中选择所需文件夹。

也可以看看

参考

外部链接

PHP 支持