PhpStorm 2025.2 Help

外部工具

将第三方命令行应用程序配置为外部工具以从 PhpStorm 运行它们。

例如，您的工作流程可能需要运行特定的 script、code generator、analyzer、preprocessor 或 postprocessor、一些 database utility 等等。 通过将其配置为外部工具，PhpStorm 为其提供了一个专用操作，您可以从主菜单、某些上下文菜单中运行它、为其分配快捷键，或在启动特定运行配置时运行它。

您可以使用 内置 IDE 宏 向工具传递上下文相关的命令行参数，例如当前文件或您的项目源路径。 如果必要，PhpStorm 将会在控制台打印工具的输出。

PhpStorm 支持以下类型的外部工具：

  • Local tools 在您的电脑上本地运行。

  • Remote tools 在远程服务器上通过 SSH 执行。

添加本地外部工具

此示例演示如何将 OptiPNG添加为外部工具，并使用它优化项目中的图像。

  1. 按 Ctrl+Alt+S 打开设置，然后选择 工具 | 外部工具。

  2. 点击 "添加"按钮 并指定工具的设置。

    创建工具对话框

    有关更多信息，请参见 外部工具。

    在我们的示例中， OptiPNG 将使用 -o4 $FilePath$ 参数运行。 您可以使用可以引用项目名称、当前文件路径、PHP 可执行文件路径等的宏。 单击 插入宏图标 将打开列出所有可用宏及其值的 宏 对话框。

  3. 点击 确定 添加工具，然后应用更改。

运行新增的本地外部工具

要在新添加的工具中打开选定的文件，请执行以下操作之一：

  • 在主菜单中，进入 工具 | 图像 | 优化 PNG。

  • 在 Project 工具窗口中右键单击一个文件，然后从上下文菜单中选择 工具 | 图像 | 优化 PNG。

    运行 External tool

  • 创建一个快捷方式来运行该工具。

    按 Ctrl+Alt+S 打开设置，然后选择 键位图。 在 外部工具 节点下找到 优化 PNG 操作，并为其分配一个快捷键。

    为外部工具创建快捷键

运行工具时，输出会显示在 运行 工具窗口中。

添加远程外部工具

远程 SSH 外部工具的配置与本地外部工具类似，但还需要定义执行这些工具的远程服务器，并需要通过 SSH 连接到该服务器的凭证。 有关使用内置 SSH 终端的更多信息，请参阅 运行 SSH 终端。

此示例演示了如何将 date 作为通过 SSH 在远程服务器上执行的远程 SSH 外部工具并返回其当前日期和时间。

  1. 按 Ctrl+Alt+S 打开设置，然后选择 工具 | 远程 SSH 外部工具。

  2. 点击 "添加"按钮 以打开 创建工具 对话框。

    创建工具对话框

    此对话框提供了与您添加 local external tool时相同的设置集，但还允许您选择远程连接。 如果您不指定连接设置，每次在服务器上运行该工具时，PhpStorm 都会要求您提供主机、端口和相关的 SSH 凭证。 更多信息请参阅 远程 SSH 外部工具。

  3. 点击 确定 添加工具，然后应用更改。

在远程服务器上运行新增的工具

请执行以下操作之一：

  • 在主菜单中，转到 工具 ｜ 远程工具 并查看所添加的远程外部工具的名称。

  • 创建一个快捷方式来运行该工具。

    按 Ctrl+Alt+S 打开设置，然后选择 键位图。 找到已配置的远程外部工具的名称，并为其分配一个快捷键。

指定主机、端口和凭证后，PhpStorm 将通过 SSH 连接到服务器并运行 date 命令，将输出返回到 PhpStorm 中的 运行 工具窗口。

Web 浏览器

您可以使用网络浏览器打开项目中的任何文件。 默认情况下，它用于预览 HTML 文件的输出或运行和调试 web 应用程序。

在网页浏览器中打开文件

要使用 Web 浏览器呈现 PHP 程序的输出，请执行以下操作之一：

  • 在编辑器中打开文件，然后按 Alt+F2。

  • 在 Project tool window 中右键点击文件，然后选择 在浏览器中打开。

  • 在主菜单中，进入 查看 | 在浏览器中打开.

  • 请使用编辑器窗口右上角的浏览器弹出窗口（悬停时出现）。 点击浏览器按钮，以打开 web 服务器文件 URL；或 Shift+Click 它以打开 本地文件 URL。

    在浏览器中显示

查看并配置浏览器列表

  • 在 设置 对话框(Ctrl+Alt+S )中，选择 工具 | Web Browsers 和预览。

“设置”中的“Web 浏览器”页面

如果浏览器是使用标准程序安装的， Path 字段中的别名应指向正确的位置。 如果没有，请指定对应可执行文件的路径。

使用自定义配置文件和设置

您可以为 Firefox 和 Chrome 系列浏览器配置自定义配置文件。

  1. 在 设置 对话框(Ctrl+Alt+S )中，选择 工具 | Web Browsers 和预览。

  2. 在列表中选择浏览器，然后点击 编辑按钮。

    • 对于 Firefox，请指定 profiles.ini 文件的路径并选择要使用的配置文件。 如需更多信息，请参阅 Firefox browser profile。

    • 对于 Chrome，选择 使用自定义用户数据目录 并指定 用户数据目录的位置。

      您还可以在从 PhpStorm 运行 Chrome 时指定其他命令行选项。 如需更多信息，请在 Chrome 地址栏中打开 chrome://flags。

最后修改日期： 2025年 9月 26日
文件范围与文件颜色浏览器