IntelliJ IDEA 2025.2 Help

PHP 参考

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

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

条目

工具提示 /

快捷键

描述

PHP 语言级别(P)

在此列表中，指定 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 language level 之间没有强制关联。 尽管每个解释器的语言版本都会自动检测，但您仍可以告诉 IntelliJ IDEA 向您提供与不同语言级别相对应的代码辅助。 但是，如果您尝试使用指定语言级别不支持的代码结构，IntelliJ IDEA 会建议一个 切换到 PHP <version> 快速修复。

当您 打开一个现有项目时，IntelliJ IDEA 会分析其中使用的语言特性，并自动设置相应的语言级别。

CLI 解释器

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

浏览按钮

Shift+Enter

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

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

路径映射

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

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

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

  • 要删除自定义映射，请在列表中选择它，然后点击 "移除"按钮。

包含路径选项卡

该区域显示已配置的 include paths列表。 包含路径用于存放 PHP 库 ，即用于补全及在某些以文件路径作为参数的函数/方法中进行引用解析的第三方代码，例如 require() 或 include()。

  • 使用 添加 和 移除 来添加和删除文件夹路径。

  • 使用 快速搜索来搜索列表：直接开始输入条目名称，或按 Ctrl+F 显示搜索字段。

  • 从 索引中排除文件夹的内容。 为此，选择文件夹，点击工具栏上的 排除此路径下的内容 ，然后在打开的文件选择器对话框中，选择要排除的嵌套文件夹路径。

PHP Runtime 选项卡

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

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

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

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

高级设置区域

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

PHP 桩代码可作为 Composer package 获取，因此可以声明并安装为某些第三方包的依赖项。 在这种情况下，它们存储在项目内的 vendor/jetbrains/phpstorm-stubs 文件夹下。

为了防止 Composer 包存根与 IntelliJ IDEA 捆绑的存根之间产生冲突，请执行以下操作之一：

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

  • 要使用 IntelliJ IDEA 自带的 PHP stubs，请确保清空 默认存根路径(D) 字段，并将 vendor/jetbrains/phpstorm-stubs 文件夹从项目中排除。

    • 如果在 语言与框架 | PHP | Composer 页面的 设置 对话框中（Ctrl+Alt+S ）启用了 作为库添加软件包(A) 选项，IntelliJ IDEA 会自动将 vendor/jetbrains/phpstorm-stubs 文件夹标记为 排除。 默认情况下，该选项已启用。

    • 如果 作为库添加软件包(A) 被禁用，您可以手动 排除 stubs 包文件夹。 为此，请在 项目 视图中右键点击 vendor/jetbrains/phpstorm-stubs 文件夹，并从上下文菜单中选择 将目录标记为 | 已排除。

分析选项卡

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

异常分析

使用此部分配置异常分析，从而改变 未处理的异常、 多余的 catch 子句、 缺少 @throws 标签和 多余的 @throws 标签检查的行为。

条目

工具提示 /

快捷键

描述

调用树分析路径

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

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

跳过使用常量形参的调用

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

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

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

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

    $date = new DateTime($myDate);

未检查的异常

请使用此列表来指定由 IntelliJ IDEA 视为未检查的例外。 在异常分析期间将跳过这些异常。

添加类

Alt+Insert

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

移除按钮

Delete

点击此按钮以从 未检查的异常 列表中删除选定的类。

自定义格式函数

将此部分用于将您的自定义字符串格式化函数包含到 Format function parameters mismatch 检查分析范围内。 此检查报告格式函数参数与规范转换项之间的不匹配，并默认分析标准 PHP printf 和 sprintf 函数的用法。

条目

工具提示 /

快捷键

描述

添加按钮

Alt+Insert

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

移除按钮

Delete

点击此按钮，以从自定义格式函数列表中移除函数记录。

编辑按钮

Enter

点击此按钮以编辑所选函数记录。

Include 分析

使用本节来定义一个自定义文件夹， $_SERVER['DOCUMENT_ROOT'] 表达式应解析到该文件夹，这将改变 未解析的包含检查的行为。

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

通常情况下，如果您的 web 服务器配置定义的文档根文件夹与 IntelliJ IDEA 项目根文件夹不同，那么应该修改此设置。

条目

描述

$SERVER['DOCUMENTROOT']

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

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

最后修改日期： 2025年 9月 22日
PHPPython