PHP命令行工具

此功能仅在Ultimate版本中受支持。

IntelliJ IDEA支持运行流行的第三方或用户定义的PHP工具的命令：Symfony 1.1 +，Symfony2， Zend Framework 1，Zend Framework 2（ZFTool）， Yii，Composer， Drush 5.8 +，Laravel和Doctrine（基于Symfony控制台） ），WordPress命令行界面。

在开始之前，请在“设置/首选项” 对话框（Ctrl+Alt+S）的“插件”页面上安装并启用PHP和命令行工具支持存储库插件。 

目前，只有本地解释器支持从IntelliJ IDEA运行PHP命令行工具 。要在远程环境中运行工具，请使用内置SSH终端。

将外部PHP命令行工具与IntelliJ IDEA集成

1. 下载并安装该工具。

2. 在“设置/首选项” 对话框（Ctrl+Alt+S）中，转到：工具|命令行工具支持。

3. 单击工具栏上的。

   • 在“命令行工具”对话框中，从列表中选择工具的类型。

   • 在“可见性”区域中，指定是要在当前项目中使用该工具还是在全局中使用该工具，即在任何IntelliJ IDEA项目中。

4. 在“别名”字段中，接受在工具命令调用中使用的默认别名，或者在必要时进行编辑。

5. 在“显示控制台”区域中，指定要输入命令的位置。

   • 弹出窗口- 选择此选项可在单独的弹出窗口中打开“命令行工具输入”窗格，并在其中键入命令。

   • 工具窗口 - 选择此选项可在专用命令行工具控制台工具窗口底部的输入字段中输入命令。

6. （可选）自定义按照自定义工具中所述设置的命令。

运行命令

运行一个命令

1. 从主菜单中，选择：工具|运行命令，或按N/A。“输入”窗格将作为弹出窗口或“命令行工具控制台”工具窗口底部的字段打开。

2. 以<tool alias> <command>格式键入命令的调用。

命令执行结果将显示在“输出”选项卡中，并带有命令名称。

保存命令输出

1. 单击“输出”选项卡工具栏的。

2. 在打开的“导出预览”对话框中，指定要存储输出的文本文件，或单击“复制”将输出保存到剪贴板。

   如果具有此名称和位置的文件已存在，请选择使用新数据覆盖其内容或将新数据附加到现有文件。

终止命令 

• 单击工具栏上的。如果“输出”选项卡已关闭，请从进度条中终止当前线程。

自定义工具

1. 在“设置/首选项” 对话框（Ctrl+Alt+S）中，转到：工具|命令行工具支持。

2. 在“命令行工具支持”页面上，选择列表中的工具，然后单击工具栏上的。该XML工具描述符在编辑器中打开。

3. 更新命令的定义。在您键入时，将动态检查工具描述符的格式。

4. 重新加载命令定义。在“命令行工具支持”页面上，选择列表中的工具，然后单击工具栏上的。

提示：重新加载命令当前仅支持 Symfony。

定义自己的命令行工具 

1. 在“设置/首选项” 对话框（Ctrl+Alt+S）中，转到：工具|命令行工具支持。

2. 单击工具栏上的，在打开的“命令行工具”对话框中，从“选择”工具列表中选择“自定义工具”，然后为其指定可见性级别（“项目”或“全局”）。

3. 在“工具设置”对话框中，键入工具的路径，工具别名，并提供该工具的简要说明。

   单击“确定”后，IntelliJ IDEA将显示“命令行工具支持”页面，其中新工具将添加到列表中。

4. 在“显示控制台”区域中，指定要输入命令的位置。

   • 弹出窗口- 选择此选项可在单独的弹出窗口中打开“命令行工具输入”窗格，并在其中键入命令。

   • 工具窗口 - 选择此选项可在专用命令行工具控制台工具窗口底部的“输入”字段中输入命令。

5. 单击“确定”接受更改并关闭“设置/首选项”对话框。

   工具定义xml文件会自动在编辑器中打开，让您可以定义工具命令。

定义工具命令

命令的定义组织如下：

<command> < !--the command's container-->
    <name>
        !--the command itself, mandatory, and non-empty-->
    </name>
    <help>
        !--the command's help message, optional-->
    </help>
    <params>
        !--the command's parameters and their default values-->
    </params>
    <optionsBefore> < !--the command's options container-->
        <option name="" shortcut=""> !--the option itself, mandatory, and non-empty; you can
        also provide a shorthand abbreviation and the usage pattern via attributes-->
            <help>
                !--the command's help message, optional-->
            </help>
        </option>
    </optionsBefore>
</command>           

保持工具描述符一致

选项1：动态验证

每次在xml工具描述符中编辑命令定义时，IntelliJ IDEA都会在运行时检查它是否格式良好。

选项2：完全验证

每次调用命令时都会执行完整验证。如果检测到任何不一致，则在“命令行工具支持”页面上使用“无效的描述”图标（）标记该工具。 

运行完整验证

1. 从主菜单中打开“输入”窗格，选择：工具|运行命令，或按N/A。“输入”窗格将作为弹出窗口或“命令行工具控制台”工具窗口底部的字段打开。

2. 要调用验证，请键入命令调用，然后在“工具定义文件错误”选项卡中，分析检测到的结构不一致的通知。每个通知都会显示问题的简要说明，文件和检测到问题的行号。

   默认情况下，当您单击“命令行工具”弹出窗口中的“显示说明”并显示错误通知时，该选项卡将被隐藏并打开。要关闭选项卡，请单击其标题上的。要重新打开它，请再次单击“更多”。

窗格的位置取决于 "命令行工具支持" 页上设置的 "显示控制台"。
“命令行工具”弹出窗口将保留在屏幕上, 直到您手动关闭它。