IntelliJ IDEA：PHP命令行工具

PHP命令行工具

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

IntelliJ IDEA支持運(yùn)行流行的第三方或用戶定義的PHP工具的命令：Symfony 1.1 +，Symfony2， Zend Framework 1，Zend Framework 2（ZFTool）， Yii，Composer， Drush 5.8 +，Laravel和Doctrine（基于Symfony控制臺(tái)） ），WordPress命令行界面。

在開始之前，請(qǐng)?jiān)凇霸O(shè)置/首選項(xiàng)” 對(duì)話框（Ctrl+Alt+S）的“插件”頁面上安裝并啟用PHP和命令行工具支持存儲(chǔ)庫插件。 

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

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

1. 下載并安裝該工具。

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

3. 單擊工具欄上的。

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

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

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

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

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

   • 工具窗口 - 選擇此選項(xiàng)可在專用命令行工具控制臺(tái)工具窗口底部的輸入字段中輸入命令。

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

運(yùn)行命令

運(yùn)行一個(gè)命令

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

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

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

保存命令輸出

1. 單擊“輸出”選項(xiàng)卡工具欄的。

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

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

終止命令 

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

自定義工具

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

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

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

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

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

定義自己的命令行工具 

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

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

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

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

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

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

   • 工具窗口 - 選擇此選項(xiàng)可在專用命令行工具控制臺(tái)工具窗口底部的“輸入”字段中輸入命令。

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

   工具定義xml文件會(huì)自動(dòng)在編輯器中打開，讓您可以定義工具命令。

定義工具命令

命令的定義組織如下：

<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>           

保持工具描述符一致

選項(xiàng)1：動(dòng)態(tài)驗(yàn)證

每次在xml工具描述符中編輯命令定義時(shí)，IntelliJ IDEA都會(huì)在運(yùn)行時(shí)檢查它是否格式良好。

選項(xiàng)2：完全驗(yàn)證

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

運(yùn)行完整驗(yàn)證

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

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

   默認(rèn)情況下，當(dāng)您單擊“命令行工具”彈出窗口中的“顯示說明”并顯示錯(cuò)誤通知時(shí)，該選項(xiàng)卡將被隱藏并打開。要關(guān)閉選項(xiàng)卡，請(qǐng)單擊其標(biāo)題上的。要重新打開它，請(qǐng)?jiān)俅螁螕簟案唷薄?/p>

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