IntelliJ IDEA：PHP命令行工具

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命令行界面。

在開始之前，請在“設(shè)置/首選項” 對話框（Ctrl+Alt+S）的“插件”頁面上安裝并啟用PHP和命令行工具支持存儲庫插件。 

目前，只有本地解釋器支持從IntelliJ IDEA運行PHP命令行工具 。要在遠(yuǎn)程環(huán)境中運行工具，請使用內(nèi)置SSH終端。

將外部PHP命令行工具與IntelliJ IDEA集成

1. 下載并安裝該工具。

2. 在“設(shè)置/首選項” 對話框（Ctrl+Alt+S）中，轉(zhuǎn)到：工具|命令行工具支持。

3. 單擊工具欄上的。

   • 在“命令行工具”對話框中，從列表中選擇工具的類型。

   • 在“可見性”區(qū)域中，指定是要在當(dāng)前項目中使用該工具還是在全局中使用該工具，即在任何IntelliJ IDEA項目中。

4. 在“別名”字段中，接受在工具命令調(diào)用中使用的默認(rèn)別名，或者在必要時進(jìn)行編輯。

5. 在“顯示控制臺”區(qū)域中，指定要輸入命令的位置。

   • 彈出窗口- 選擇此選項可在單獨的彈出窗口中打開“命令行工具輸入”窗格，并在其中鍵入命令。

   • 工具窗口 - 選擇此選項可在專用命令行工具控制臺工具窗口底部的輸入字段中輸入命令。

6. （可選）自定義按照自定義工具中所述設(shè)置的命令。

運行命令

運行一個命令

1. 從主菜單中，選擇：工具|運行命令，或按N/A?！拜斎搿贝案駥⒆鳛閺棾龃翱诨颉懊钚泄ぞ呖刂婆_”工具窗口底部的字段打開。

2. 以<tool alias> <command>格式鍵入命令的調(diào)用。

命令執(zhí)行結(jié)果將顯示在“輸出”選項卡中，并帶有命令名稱。

保存命令輸出

1. 單擊“輸出”選項卡工具欄的。

2. 在打開的“導(dǎo)出預(yù)覽”對話框中，指定要存儲輸出的文本文件，或單擊“復(fù)制”將輸出保存到剪貼板。

   如果具有此名稱和位置的文件已存在，請選擇使用新數(shù)據(jù)覆蓋其內(nèi)容或?qū)⑿聰?shù)據(jù)附加到現(xiàn)有文件。

終止命令 

• 單擊工具欄上的。如果“輸出”選項卡已關(guān)閉，請從進(jìn)度條中終止當(dāng)前線程。

自定義工具

1. 在“設(shè)置/首選項” 對話框（Ctrl+Alt+S）中，轉(zhuǎn)到：工具|命令行工具支持。

2. 在“命令行工具支持”頁面上，選擇列表中的工具，然后單擊工具欄上的。該XML工具描述符在編輯器中打開。

3. 更新命令的定義。在您鍵入時，將動態(tài)檢查工具描述符的格式。

4. 重新加載命令定義。在“命令行工具支持”頁面上，選擇列表中的工具，然后單擊工具欄上的。

提示：重新加載命令當(dāng)前僅支持 Symfony。

定義自己的命令行工具 

1. 在“設(shè)置/首選項” 對話框（Ctrl+Alt+S）中，轉(zhuǎn)到：工具|命令行工具支持。

2. 單擊工具欄上的，在打開的“命令行工具”對話框中，從“選擇”工具列表中選擇“自定義工具”，然后為其指定可見性級別（“項目”或“全局”）。

3. 在“工具設(shè)置”對話框中，鍵入工具的路徑，工具別名，并提供該工具的簡要說明。

   單擊“確定”后，IntelliJ IDEA將顯示“命令行工具支持”頁面，其中新工具將添加到列表中。

4. 在“顯示控制臺”區(qū)域中，指定要輸入命令的位置。

   • 彈出窗口- 選擇此選項可在單獨的彈出窗口中打開“命令行工具輸入”窗格，并在其中鍵入命令。

   • 工具窗口 - 選擇此選項可在專用命令行工具控制臺工具窗口底部的“輸入”字段中輸入命令。

5. 單擊“確定”接受更改并關(guān)閉“設(shè)置/首選項”對話框。

   工具定義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：動態(tài)驗證

每次在xml工具描述符中編輯命令定義時，IntelliJ IDEA都會在運行時檢查它是否格式良好。

選項2：完全驗證

每次調(diào)用命令時都會執(zhí)行完整驗證。如果檢測到任何不一致，則在“命令行工具支持”頁面上使用“無效的描述”圖標(biāo)（）標(biāo)記該工具。 

運行完整驗證

1. 從主菜單中打開“輸入”窗格，選擇：工具|運行命令，或按N/A?！拜斎搿贝案駥⒆鳛閺棾龃翱诨颉懊钚泄ぞ呖刂婆_”工具窗口底部的字段打開。

2. 要調(diào)用驗證，請鍵入命令調(diào)用，然后在“工具定義文件錯誤”選項卡中，分析檢測到的結(jié)構(gòu)不一致的通知。每個通知都會顯示問題的簡要說明，文件和檢測到問題的行號。

   默認(rèn)情況下，當(dāng)您單擊“命令行工具”彈出窗口中的“顯示說明”并顯示錯誤通知時，該選項卡將被隱藏并打開。要關(guān)閉選項卡，請單擊其標(biāo)題上的。要重新打開它，請再次單擊“更多”。

窗格的位置取決于 "命令行工具支持" 頁上設(shè)置的 "顯示控制臺"。
“命令行工具”彈出窗口將保留在屏幕上, 直到您手動關(guān)閉它。