# WP-CLI  v1.3.0  發行說明

*Published:* 2017-08-09
*Author:* 殼殼蟲

釋出日快樂！經過總共 210 個合併的拉取請求，我們很高興為您帶來 WP-CLI[4](#341cb11e) v1.3.0。

使用縮短的識別符號安裝包
------------

最近，我們一直在討論 WP-CLI 包索引的未來。我們的結論是暫時廢棄現有的包索引，為更輕鬆地安裝託管在 GitHub[3](#13e274fc) 上的外部命令提供新的機制。

從 WP-CLI v1.3.0 開始，每當您以 `<vendor>/<package>` 的形式提供包識別符號時，WP-CLI 首先檢查已棄用的包索引（出於向後相容性的原因），然後檢查是否存在與此識別符號匹配的 GitHub 儲存庫。這還接受 Composer[1](#d34f15ce) 可解析的所有版本限定符/要求。

示例：

```
# 從 GitHub 安裝 vendor/command（使用 https://github.com/vendor/command）：
$ wp package install vendor/command

# 安裝版本 1.0.5 的 vendor/command：
$ wp package install vendor/command:v1.0.5

# 安裝 commit 95ce52b 的 vendor/command：
$ wp package install vendor/command:dev-master#95ce52b

```

新命令
---

想知道資料庫中是否存在特定字串？不再疑惑！使用新的 `wp db search` 來搜尋資料庫中的所有文字列，以查詢您指定的字串（或正規表示式模式）\[#29, #33\]：

```
# 搜尋資料庫中的 'http://' 正規表示式，列印統計資訊。
$ wp db search 'http:\/\/' --regex --stats
wp_comments:comment_author_url
1:https://wordpress.org/
    ...
成功：在 10.752 秒內找到 99146 個匹配項（10.559 秒搜尋）。搜尋了 12 個表，53 個列，1358907 行。跳過了 1 個表：wp_term_relationships。

```

需要輕鬆訪問資料庫字首以連結到其他命令嗎？使用 `wp db prefix` 來列印它\[#22\]：

```
$ wp db prefix --url=example.com/foo
wp_3_

```

v1.3.0 的其他內容
------------

**命令改進**

- `wp config *`: 
    - 在找不到 `wp-config.php` 時提前報錯\[#22\]。
- `wp config create`: 
    - 本地生成金鑰/鹽，作為 WordPress.org API[6](#b46b8435) 的備用\[#25\]。
- `wp config get`: 
    - 新增 `--constant=<constant>` 或 `--global=<global>` 以獲取特定常量或全域性變數的值\[#16\]。
    - 指示由 `wp-config.php` 包含的檔案\[#18\]。
- `wp core (multisite-install|multisite-convert)`: 
    - 使用 `--skip-config` 避免將 multisite 常量新增到 `wp-config.php` 檔案\[#18\]。
- `wp import`: 
    - 防止不存在的目錄出現在要匯入的檔案列表中\[#8\]。
- `wp media *`: 
    - 在大多數情況下將媒體名詞更改為’items’，以反映媒體的多型別特性\[#18\]。
- `wp media import`: 
    - 新增 `--skip-copy` 標誌，允許從本地檔案系統匯入媒體而不移動在磁碟上\[#21\]。
- `wp package install`: 
    - 新增對短包識別符號的支援\[#22\]。
- `wp post term delete`: 
    - 實現 `--all` 標誌以從帖子中刪除所有術語\[#23\]。
- `wp scaffold *`: 
    - 建立 `phpcs.xml.dist` 而不是自定義命名的 `phpcs.ruleset.xml` \[#19\]。
    - 更好地支援符號連結\[#26\]。
    - 更改 `addtextdomain` 的 grunt 配置，以預設覆蓋所有文字域\[#28\]。
- `wp search-replace`: 
    - 包括 `--format=count`，只顯示受影響的行數\[#14\]。
- `wp term (get|update|delete)`: 
    - 引入 `--by=<type>` 引數，用於按 slug 獲取/更新/刪除術語\[#27\]。
- `wp user *`: 
    - 支援使用登入欄位中的電子郵件地址來獲取使用者\[#21\]。
- `wp super-admin remove`: 
    - 允許撤銷不存在使用者的超級管理員許可權\[#6\]。

**框架增強**

- 修復 `$custom_vendor` 條件的自動載入檔名\[#4147\]。
- 儲存執行時配置，以便將其作為引數傳遞給 `Runner::run_alias_group()` 呼叫\[#4148\]。
- 如果停用 `opcache.save_comments`，則手動載入評論\[#4161\]。
- 允許子命令名稱和引數中包含數字\[#4164, #4269\]。
- 修復 `boot-phar.php` 路徑中的雙斜槓\[#4169\]。
- 允許根使用 `wp cli info`，以及 `wp cli update`\[#4177\]。
- 更新 SSH[7](#b467c805) URL[8](#f38e9e9d) 解析正規表示式，以允許空埠號\[#4182\]。
- 新增 `WP_CLI\Utils\get_home_dir()` 輔助函式\[#4184\]。
- 減少內建 Phar 中包括的檔案（尤其是 Behat/PHPUnit）\[#4185\]。
- Behat：允許透過環境變數設定測試資料庫使用者+密碼\[#4196\]。
- 在編碼錯誤發生時，修復 JSON[5](#7d4a2a17) 格式的輸出\[#4199\]。
- 如果設定，將 `WP_CLI_STRICT_ARGS_MODE` 傳遞給 `--ssh=<ssh>`\[#4207\]。
- 在找不到站點時顯示更有幫助的錯誤訊息\[#4212\]。
- 由於換行符的原因，在 Windows 系統上修復損壞的縮排\[#4221, #4222\]。
- 使 `--ssh=<ssh>` 標誌適用於 Docker[2](#1e126004) 和 Docker Compose\[#4240\]。
- 在各種場景中檢查 `proc_open/close` 的可用性\[#4245\]。

**本次釋出的貢獻者（總共 45 位）：** aaemnnosttv, BhargavBhandari90, chetansatasiya, chriszarate, cjhaas, colemanedwards, danielbachhuber, davetha, drrobotnik, electrokit, emgk, emirpprime, erikjoling, fjarrett, freegenie, gitlost, greatislander, iansvo, Ippey, jalavoy, jameselks, joehoyle, johnbillion, @JPry, junaidbhura, kouratoras, lucatume, @mapk, mikeschinkel, miya0001, @murtzsarialtun**,** nikolov-tmw, pierre-dargham, plastikdreams, rahul286, ronaksampat, schlessera, Sidsector9, soulseekah, szepeviktor, tfrommen, vbaranovskiy-plesk, westonruter, wp-make-coffee, wpbullet

### 名詞解釋

1. Composer：PHP 的依賴管理工具 [↩︎](#d34f15ce-link)
2. Docker：容器化部署工具，將應用打包到隔離環境中執行 [↩︎](#1e126004-link)
3. GitHub：全球最大的程式碼託管和協作開發平臺 [↩︎](#13e274fc-link)
4. WP-CLI：WordPress 的命令列管理工具 [↩︎](#341cb11e-link)
5. JSON：一種輕量級的資料交換格式 [↩︎](#7d4a2a17-link)
6. API：應用程式程式設計介面，軟體之間互動的標準方式 [↩︎](#b46b8435-link)
7. SSH：安全外殼協議，用於遠端登入和管理伺服器 [↩︎](#b467c805-link)
8. URL：統一資源定位符，即網址 [↩︎](#f38e9e9d-link)
<!-- WP Chinese Converter Full Page Converted. Target Lang: zh-tw -->