PHP规范

最后修改时间：2021 年 5 月 19 日

此对话框仅在安装并启用PHP和PHPSpec插件时可用。默认情况下激活插件。如果插件被禁用，请在插件页面的已安装选项卡上启用它们，如安装插件中所述。

使用此对话框创建配置，用于使用PHPSpec工具集在 PHP 应用程序上运行和调试单元测试。

在你开始前

运行PHPSpec测试：

  1. 如PHPSpec中所述，在您的计算机上安装和配置PHPSpec工具集。

  2. 确保启用了PHP和PHPSpec插件。

    默认情况下激活插件。如果插件被禁用，请在插件页面的已安装选项卡上启用它们，如安装插件中所述。

试跑者区

在此区域中，指定要启动的规范和要传递给PHPSpec的命令行开关。

物品

描述

测试范围

在此区域中，指定规范的位置或列出它们的配置文件。

  • 目录：选择此选项以启动目录中的所有规范。

    在目录字段中，指定目录以搜索带有规范的*Spec.php文件。手动键入目录的路径或单击浏览并在打开的 选择测试目录对话框中选择浏览按钮所需的目录。

  • 文件：选择此选项以启动特定*Spec.php文件中的所有规范。

    1. 在文件字段中，指定*Spec.php文件以在其中搜索规范。手动键入文件的路径或单击浏览 浏览按钮并在打开的对话框中选择所需的目录。

    2. 在类字段中，指定所需的类。手动键入类名称或单击浏览 浏览按钮并在打开的树视图中选择所需的类。

  • 规格：选择此选项以启动特定规格。

    1. 在文件字段中，指定要在其中搜索规范的*Spec.php文件。手动输入文件名或单击浏览 浏览按钮并在打开的树视图中选择所需文件。

    2. 在规范字段中，键入所需的规范。

  • 在配置文件中定义：选择此选项让PHPSpec从专用的.yml配置文件执行测试。

    默认情况下，PHPSpec使用Test Frameworks页面的Test Runner区域中指定的配置文件。反过来，这可以是本机配置文件（phpspec.yml或phpspec.yml.dist）或任何其他YML配置文件，您在 PhpStorm中PHPSpec的初始配置期间将其指定为默认值。

    • 要使用所有PHPSpec运行配置文件的默认值，请清除使用替代配置文件复选框。

    • 要从自定义配置文件启动规范，请选中使用替代配置文件复选框并在其旁边的字段中指定所需YML文件的位置。

    • 要打开PHPSpec页面并指定要使用的另一个默认配置文件，请单击设置按钮按钮。

命令行区域

在此区域中，选择 PHP 解释器并通过指定要传递给 PHP 可执行文件的选项和参数来自定义其行为。

物品

描述

口译员

该列表包含所有当前配置的本地和远程 PHP 解释器。从列表中选择一个已配置的 PHP 解释器，或单击浏览按钮并定义一个新的解释器，如配置本地 PHP 解释器和配置远程 PHP 解释器中所述。

口译员选项

在此字段中，指定要传递给 PHP 可执行文件的选项。它们覆盖 PHP 解释器的默认行为或确保执行其他活动。

如有必要，单击并在“命令行选项”对话框展开按钮中键入所需的选项。在新行上键入每个选项。当您关闭对话框时，它们都显示在命令行选项字段中，并以空格作为分隔符。

自定义工作目录

在此字段中，指定包含测试的文件夹之外的文件的位置，并通过相对路径在测试中引用。

此设置不会阻止测试执行，因为始终通过相应文件和/或目录的完整路径指定测试的位置。

默认情况下，该字段为空，工作目录为项目的根目录。

环境变量

在此字段中，指定要传递给内置服务器的环境变量。有关详细信息，请参阅Apache中的环境变量。

常用设置

当您编辑运行配置（但不是运行配置模板）时，您可以指定以下选项：

姓名

为运行/调试配置指定一个名称，以便在编辑或运行配置时快速识别它，例如，从运行弹出窗口Alt+Shift+F10中。

允许并行运行

选择以允许并行运行此运行配置的多个实例。

默认情况下，它是禁用的，当您在另一个实例仍在运行时启动此配置时，PhpStorm 建议停止正在运行的实例并启动另一个实例。当运行/调试配置消耗大量资源并且没有充分理由运行多个实例时，这很有帮助。

存储为项目文件

使用运行配置设置保存文件以与其他团队成员共享。默认位置是.idea/runConfigurations。但是，如果您不想共享.idea目录，您可以将配置保存到项目中的任何其他目录。

默认情况下，它被禁用，并且 PhpStorm 将运行配置设置存储在.idea/workspace.xml中。

工具栏

运行/调试配置的树视图有一个工具栏，可帮助您管理项目中可用的配置以及调整默认配置模板。

物品

捷径

描述

添加按钮

Alt+Insert

创建运行/调试配置。

删除按钮

Alt+Delete

删除选定的运行/调试配置。请注意，您不能删除默认配置。

复制

Ctrl+D

创建所选运行/调试配置的副本。请注意，您会创建默认配置的副本。

保存配置

仅当您选择临时配置时才会显示该按钮。单击此按钮可将临时配置保存为永久配置。

移动到新文件夹/创建新文件夹

移动到新文件夹/创建新文件夹。您可以通过将运行/调试配置放入文件夹来对它们进行分组。

要创建文件夹，请选择类别中的配置，单击文件夹，然后指定文件夹名称。如果仅关注一个类别，则会创建一个空文件夹。

然后，要将配置移入文件夹、文件夹之间或移出文件夹，请使用拖动或提升和下移按钮。

要删除分组，请选择一个文件夹并单击删除配置。

排序配置

单击此按钮可按字母顺序对配置进行排序。

发射前

在此区域中，您可以指定在开始选定的运行/调试配置之前要执行的任务。任务按照它们在列表中出现的顺序执行。

物品

捷径

描述

添加按钮

Alt+Insert

单击此图标可添加以下可用任务之一：

  • 运行外部工具：选择运行外部应用程序。在打开的对话框中，选择一个或多个要运行的应用程序。如果尚未在 PhpStorm 中定义，请添加其定义。有关详细信息，请参阅外部工具和外部工具。

  • 运行另一个配置：选择执行另一个运行/调试配置。在打开的对话框中，选择要运行的配置。

  • 启动 Web 浏览器：选择此选项以启动浏览器。在打开的对话框中，选择浏览器类型并提供起始 URL。此外，指定是否希望使用 JavaScript 调试器启动浏览器。

  • 运行文件观察器：选择此选项让 PhpStorm 应用所有当前活动的文件观察器。

  • 运行 Grunt 任务：选择此选项以运行 Grunt 任务。

    在打开的Grunt 任务对话框中，指定定义所需任务的Gruntfile.js，选择要执行的任务，并指定要传递给 Grunt 工具的参数。

    指定 Node.js 解释器的位置、传递给它的参数以及grunt-cli包的路径。

  • 运行 gulp 任务：选择此选项以运行 Gulp 任务。

    在打开的Gulp 任务对话框中，指定定义所需任务的Gulpfile.js，选择要执行的任务，并指定要传递给 Gulp 工具的参数。

    指定 Node.js 解释器的位置、传递给它的参数以及gulp包的路径。

  • 运行 npm 脚本：选择此选项以执行 npm 脚本。

    在打开的NPM 脚本对话框中，指定npm 运行/调试配置设置。

  • 编译 TypeScript：选择运行内置的 TypeScript 编译器，从而确保您对 TypeScript 代码所做的所有更改都反映在生成的 JavaScript 文件中。在打开的TypeScript 编译设置对话框中，选中或清除检查错误复选框以配置编译器在检测到任何错误时的行为：

    • 如果选中检查错误复选框，编译器将显示所有错误并且不会启动运行配置。

    • 如果检查错误复选框被清除，编译器将显示所有检测到的错误，但仍将启动运行配置。

  • 运行 Phing 目标：添加此任务以在运行或调试之前执行指定的Phing目标。要指定 Phing 目标，请单击浏览 浏览按钮并在打开的对话框中选择所需的目标。

  • 生成 CoffeeScript Source Maps：选择此选项可为您的CoffeeScript源生成源映射。在打开的对话框中，指定 CoffeeScript 源文件的位置。

  • 将文件上传到远程主机：选择此选项可根据默认的服务器访问配置将应用程序文件自动上传到服务器。

  • 运行远程外部工具：添加远程 SSH 外部工具。

删除按钮

Alt+Delete

单击此图标可从列表中删除选定的任务。

编辑

Enter

单击此图标可编辑选定的任务。在打开的对话框中进行必要的更改。

方法向上/方法向下

Alt+Up/Alt+Down

单击这些图标可在列表中将所选任务向上或向下移动一行。任务按照它们在列表中出现的顺序执行。

显示此页面

选中此复选框可在实际启动运行/调试配置之前显示运行/调试配置设置。

激活工具窗口

默认情况下，此复选框处于选中状态，当您启动运行/调试配置时，运行或调试工具窗口将打开。

否则，如果清除该复选框，则隐藏工具窗口。但是，在配置运行时，您可以通过按Alt+4或自行为其打开相应的工具窗口Alt+5。