PhpStorm 2021.3 Help

PHP

该页面和该节点下的所有页面仅在启用PHP插件时可用。PHP插件与PhpStorm 捆绑在一起并默认激活。如果插件被禁用，请在设置/首选项的已安装选项卡上启用它。插件页面，如管理插件中所述。

使用此页面通过选择可用的 PHP 解释器之一来配置项目中的 PHP 开发和单元测试支持，请参阅配置本地 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 版本。

项目中使用的 PHP 版本与语言级别之间没有强制执行相关性。尽管会自动检测每个解释器的语言版本，但您仍然可以告诉 PhpStorm 为您提供与不同语言级别相对应的编码帮助。但是，如果您尝试使用指定语言级别不支持的代码结构，PhpStorm 建议使用Switch to PHP <version> quick-fix。

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

CLI 解释器

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

浏览按钮

Shift+Enter

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

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

路径映射

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

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

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

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

包含路径选项卡

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

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

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

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

PHP 运行时选项卡

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

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

  • 要加载与当前配置的 CLI 解释器的加载扩展集匹配的存根集，请单击Sync Extensions with Interpreter按钮。有关配置解释器的详细信息，请参阅配置本地 PHP 解释器和配置远程 PHP 解释器。

在Project 工具窗口中，当前加载的存根显示在External Libraries节点下。

高级设置区

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

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

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

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

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

    • 如果在PHP |上启用了将包添加为库选项。Settings/Preferences对话框 ( ) 的Composer页面，PhpStorm 自动将 vendor/ jetbrains /phpstorm-stubs文件夹标记为 exclude 。默认情况下，该选项已启用。Ctrl+Alt+S

    • 如果禁用将包添加为库，您可以手动排除存根包文件夹。为此，在Project视图中，右键单击 vendor/jetbrains/phpstorm-stubs文件夹并选择Mark Directory as | 从上下文菜单中排除。

分析选项卡

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

异常分析

使用此部分配置异常分析，这会改变Unhandled exception、Redundant catch 子句、Missing @throws tag(s)和Redundant @throws tag(s)检查的行为。

物品

工具提示 /

捷径

描述

调用树分析深度

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

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

使用常量参数跳过调用

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

  • 跳过只有字符串或常量作为参数的方法调用：

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

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

    $date = new DateTime($myDate);

未经检查的异常

使用此列表来指定被 PhpStorm 视为未检查的异常。在异常分析期间会跳过此类异常。

添加类

Alt+Insert

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

删除按钮

Delete

单击此按钮可从Unchecked Exceptions列表中删除选定的类。

自定义格式函数

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

物品

工具提示 /

捷径

描述

添加按钮

Alt+Insert

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

删除按钮

Delete

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

编辑按钮

Enter

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

包括分析

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

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

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

物品

描述

$SERVER['DOCUMENTROOT'

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

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

最后修改：2022 年 2 月 14 日
设置/首选项 CLI 解释器