WP-CLI v1.2.0 發行說明

“

釋出日快樂！

經過325個合併的拉取請求，我們很高興地為您帶來WP-CLI v1.2.0，其中包含了許多增強功能、錯誤修復以及引導重構。

但首先…

我們有一個新的標誌！

即將出現在您附近的筆記型電腦上：

感謝Chris Wallace和Lift UX團隊的工作，以及所有對我的反饋做出回應的人。

命令抽象到不同的包

我們將專案分解了！

主要的wp-cli/wp-cli倉庫現在只包含框架本身。所有捆綁的命令都可以在單獨的倉庫中找到。例如，wp cache *系列命令現在位於github.com/wp-cli/cache-command。

這種抽象提供了一些好處：

• 在開發時，只對您正在工作的特定元件執行測試，使反饋迴圈更短。
• 可以獨立控制和設定各個命令包，為更好的協作提供機會。
• 可以釋出各個命令的熱修復和中間版本，然後透過內建的包管理器進行更新。
• 現在測試執行非常快。
• 當您提交拉取請求時，無需等待兩個小時來執行測試。

對於使用Composer的WP-CLI使用者，您可以像通常貢獻Composer依賴關係一樣為包做出改進。使用composer install --prefer-source來安裝Git克隆的依賴項。

對於透過Phar可下載的WP-CLI使用者，您可以透過安裝包（將覆蓋捆綁版本）來貢獻改進。例如，對於快取命令，可以使用以下命令：

$ wp package install git@github.com:wp-cli/cache-command.git
$ cd $(wp package path wp-cli/cache-command)

檢視#3728以瞭解原始歷史。要更好地瞭解底層基礎架構，請閱讀Alain關於新的引導機制、管理命令依賴和依賴關係解決機制的帖子。

接下來：貢獻工作流程

包抽象和引導過程的投資是我們改進貢獻工作流程的一部分。

最終，我們希望為專案的貢獻提供：

• 輕鬆。 雖然瞭解WP-CLI程式碼庫需要一定的技術知識，但那些能夠為程式碼庫做出貢獻的人應該能夠儘量少地增加負擔。
• 愉快。 改進WP-CLI應該是有趣的，有回報的。對於貢獻者來說，這意味著定義明確的入口點、足夠的工作流程檔案、清晰表達的願景、路線圖和決策過程等等。

對於新貢獻者，我們現在有一個“Good First Issues”頁面：

對於提交者，我們現在有一個自定義儀錶板的開端：

貢獻工作流程的工作是一個持續進行的過程。我們還沒有深入挖掘。

可以期待在構成貢獻者體驗的一些關鍵領域看到很多工作：

• 明確決策過程，將想法轉化為新命令。我們需要找出如何可持續地將想法轉化為維護的包。
• 透過檔案、工具和流程改進新提交者的入職流程。閱讀提交者信仰以更好地瞭解我們的期望。

在我們的每週辦公時間或WordCamp Europe期間加入對話，時間為2017年4月26日星期三GMT+8上午12:00。

新命令

想要檢查您的wp-config.php是否正常？使用wp config get列出wp-config.php中定義的常量和全域性變數[#9]

$ wp config get --fields=key,value
+--------------------+-----------------+
| key                | value           |
+--------------------+-----------------+
| table_prefix       | wp_             |

不想記住wp-config.php在檔案系統中的位置？使用wp config path來獲取wp-config.php的路徑[#7]

# 在您的編輯器中編輯wp-config.php。
$ vim $(wp config path)

想知道您的資料庫有多重？執行wp db size來獲取資料庫和其表的大小[#16]

$ wp db size --tables
+-----------------------+--------+
| Name                  | Size   |
+-----------------------+--------+
| wp_users              | 64 KB  |
| wp_usermeta           | 48 KB  |
| wp_posts              | 4 MB   |
| wp_comments           | 2 MB   |
| wp_links              | 32 KB  |
| wp_options            | 1 MB   |
| wp_postmeta           | 8 MB   |
| wp_terms              | 416 KB |
| wp_term_taxonomy      | 336 KB |
| wp_term_relationships | 736 KB |
| wp_termmeta           | 48 KB  |
| wp_commentmeta        | 2 MB   |
+-----------------------+--------+

v1.2.0中的其他一切

命令改進

• wp core install：
  • 為管理員使用者生成18字元的密碼[#4002]。
• wp cron event run：
  • 僅在使用--due-now傳遞$args時執行指定的事件[#11]。
• wp db *：
  • 在呼叫MySQL可執行檔案時，使用/usr/bin/env mysql而不是mysql[#14]。
• wp db (drop|reset)：
  • 在wp db drop和wp db reset命令的確認提示中顯示資料庫名稱[#12]。
• wp db export：
  • 在匯出資料庫時新增--exclude_tables=<tables>選項[#20]。
• wp db import：
  • 透過停用自動提交和（唯一和外部索引鍵）鍵檢查來加速匯入過程[#3829]。
• wp language core install：
  • 即使語言已安裝，也會處理--activate標誌[#3851]。
• wp language core (install|uninstall)
  • 允許一次安裝或解除安裝多種語言[#4, #5]。
• wp media import：
  • 以多種方式改進錯誤處理[#3755]。
• wp media regenerate：
  • 在重新生成時刪除現有的PDF預覽影像[#3824]。
  • 修復當影像尺寸小於註冊的影像尺寸時的媒體重新生成[#5]。
  • 新增--image_size=<size>以重新生成特定影像大小[#9]。
• wp menu location assign：
  • 增加了詳細程度和錯誤報告[#3852]。
• wp package *：
  • 修復了在Windows下從get_composer_json_path()返回的路徑[#11]。
• wp plugin install：
  • 在從GitHub原始ZIP URL安裝時停用重新命名行為[#3823]。
• wp plugin update：
  • 引入了--minor和--patch標誌，以限制基於語義版本的更新[#13]。
  • 在外掛更新失敗時顯示正確的錯誤[#3803]。
• wp (plugin|theme) update：
  • 新增--exclude=<name>引數以排除更新外掛或主題[#16]。
• wp post term *：
  • 引入了--by=id引數以顯式處理術語作為ID[#3896]。
  • 基於術語計數來複數化訊息[#3898]。
• wp rewrite *：
  • 在使用--skip-plugins或--skip-themes管理重寫時，警告使用者，因為重寫可能會丟失[#3917]。
• wp scaffold (child-theme|_s)：
  • 包括基於WordPress編碼標準的預設.editorconfig[#3902]。
• wp scaffold plugin-tests
  • 對 .travis.yml 和 circle.yml 進行了多項改進 [#3919]。
  • 在 .travis.yml 中快取 Composer [#3816]。
  • 為 PHP 5.* 安裝 PHPUnit 4.8.*，為其他版本安裝 PHPUnit 5.7.* [#6]。
  • 在 circle.yml 中測試 PHP 7 版本 [#16]。
• wp server:
  • 允許使用環境變數定義特定的 PHP 二進位制檔案 [#3868]。
• wp user create:
  • 為新使用者生成 24 位密碼 [#7]。
• wp user import-csv:
  • 在更新使用者時停用 core 的電子郵件通知 [#3904]。

框架增強

• 現在 WP-CLI 可以與 Symfony 3.x 元件一起使用，而且無需破壞向後相容性 [#4067]。
• 新增 hooks:
  • before_add_command:<parent command> 允許您在新增命令之前檢查執行時要求
  • after_add_command:<parent command> 允許您在觸發特定父命令之前依賴於父命令 [#4033]。
• 自動命令依賴解析。如果子命令依賴於尚未註冊的父命令，那麼將延遲新增子命令，直到父命令可用 [#4094]。
• 拼寫建議。如果您輸入命令時出現拼寫錯誤，WP-CLI 現在足夠智慧，會建議您可能想要輸入的內容，並建議這些更正的拼寫。這有助於發現和解決錯誤。拼寫建議適用於命令、引數和別名 [#4004，#4008，#4109]。
• 預設情況下，幫助檔案每行不超過 80 個字元。以前也有自動換行，但不一致，所以經常出現問題 [#4105]。
• 多種測試框架改進：
  • 在子目錄路徑中替換變數 [#4085]。
  • 安全地強制刪除 RUN_DIR，以確保 Behat 不會在清理時掛起 [#4112]。
  • 以跨平臺相容的方式終止所有啟動的後臺程式 [#4074]。
  • 僅在 WP_VERSION 不是“latest”或“nightly”時應用 @require-wp 標籤，以確保在這些上下文中執行完整的測試套件 [#4055]。

本次釋出的貢獻者（總共 43 位）： 1naveengiri，aaemnnosttv，afragen，balbuf，behzod，carl-alberto，CodeProKid，danielbachhuber，davgothic，diablodale，diggy，dnmvisser，fjarrett，flaskboy，geekoun，gitlost，hason，JayWood，jeremyfrady，ka7，kcarwilemiller，lichtscheu，mbovel，MiteshShah，miya0001，Nikschavan，ntwb，petenelson，rahul3883，raquelmsmith，Rarst，ryanshoover，schlessera，Sidsector9，SosyalAlkolik，ssnepenthe，Steveorevo，tfrommen，tillkruss，timdream，trepmal，wp-make-coffee，zacksheppard