WP-CLI は WordPress 向けのコマンドラインインターフェースです。Plugin のインストール、ユーザー管理、データベース操作などを WordPress 管理画面に触れることなくターミナルから実行できます。このガイドでは、Linux・macOS・Windows へのインストール手順と、よくある失敗パターンの確認・トラブルシューティング手順を解説します。
TL;DR: Linux または macOS の phar 方式では、Phar ファイルをダウンロードし、実行可能にして、PATH に配置します。macOS で最も速いのは
brew install wp-cliです。Windows では Cygwin をインストールするか WSL2 を使い、続いて Linux の手順に従ってください。インストールが成功したかはwp --versionで確認できます。
プラットフォーム別の方法早見表
| プラットフォーム | 推奨される方法 | 代替手段 |
|---|---|---|
| Linux | curl (phar) | Composer |
| macOS | Homebrew (brew install wp-cli) |
curl (phar) |
| Windows (Cygwin) | Cygwin ターミナルで curl (phar) | — |
| Windows (WSL2) | WSL2 内で Linux の手順に従う | — |
WP-CLI は Composer パッケージとしてもインストールできます。require wp-cli/wp-cli の手順は 公式 WP-CLI ドキュメントを参照してください。
前提条件
- PHP 5.4 以降
- WordPress 3.7 以降
- Linux でのインストールにはサーバーへの SSH アクセス
- Windows でのインストールには管理者権限
Linux でのインストール
- WP-CLI をダウンロードする:
ターミナルウィンドウを開き、curl を使って WP-CLI の Phar ファイルをダウンロードします:
curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar当社の Ubuntu 22.04 LTS でのテストでは、curl 方式は標準的なサーバー接続で 1 分以内に完了します。
- WP-CLI を実行可能にする:
ダウンロードした Phar ファイルを実行可能にします:
chmod +x wp-cli.phar- WP-CLI を bin ディレクトリに移動する:
実行ファイルを PATH 内のディレクトリに移動します。/usr/local/bin ディレクトリが標準的な配置場所です:
sudo mv wp-cli.phar /usr/local/bin/wp- WP-CLI のインストールを確認する:
WP-CLI が正しくインストールされているかを、システム情報を表示して確認します:
wp --infomacOS でのインストール
macOS は多くの WordPress 開発者にとって主要な開発環境です。Homebrew 方式が最もシンプルで、WP-CLI を自動的に最新の状態に保てます。
Homebrew でインストールする (推奨)
Homebrew がインストールされている場合は、次を実行します:
brew install wp-cliインストール後、動作することを確認します:
wp --versionPhar でインストールする (Homebrew なし)
手動の方法を好む場合は、Linux の Phar 手順がそのまま macOS でも動作します:
curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
chmod +x wp-cli.phar
sudo mv wp-cli.phar /usr/local/bin/wp
wp --versionWindows でのインストール
- WP-CLI をダウンロードする:
WP-CLI の GitHub ページを訪問し、次の URL から最新の Phar ファイルをダウンロードします:
https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar- Cygwin をダウンロードしてインストールする:
WP-CLI には Unix 系ターミナルが必要です。公式サイトから Cygwin をダウンロードしてインストールしてください:
https://www.cygwin.com/インストール中は、curl、php、php-curl、php-mbstring、openssl、openssh パッケージをインストールするようにしてください。
- WP-CLI を Cygwin ディレクトリに移動する:
wp-cli.phar ファイルを Cygwin のホームディレクトリ (通常は C:cygwin64homeYour_User) に移動します。
- WP-CLI を実行可能にする:
Cygwin ターミナルを開いて cd ~ でホームディレクトリに移動します。続いて Phar ファイルを実行可能にします:
chmod +x wp-cli.phar- WP-CLI を bin ディレクトリに移動する:
実行ファイルを PATH に移動します。Cygwin 内の /usr/bin ディレクトリが標準的な配置場所です:
mv wp-cli.phar /usr/bin/wp- WP-CLI のインストールを確認する:
WP-CLI が正しくインストールされているかを、システム情報を表示して確認します:
wp --infoインストールを確認する
どの方法で WP-CLI をインストールした後でも、次の 2 つのコマンドで動作を確認できます。
バージョンを確認する:
wp --versionこのコマンドは WP-CLI x.y.z のようなバージョン文字列を出力します。最新バージョンであることは、WP-CLI のリリースページで確認してください。
基本的なヘルスチェックを実行する:
wp doctor checkこれは一般的な設定の問題をチェックします。サイト固有の結果を得るには、WordPress のディレクトリ内から実行してください。doctor コマンドは wp-cli/doctor-command パッケージの一部で、別途インストールが必要です。セットアップ手順は wp-cli/doctor-command の README を参照してください。
トラブルシューティング
WP STAGING のサポートチケットによると、WP-CLI のインストール失敗で最も多い原因は PATH の設定ミスです。以下は主な失敗パターンとその修正方法です。
インストール後に wp: command not found が出る (Linux / macOS)
WP-CLI の Phar が $PATH 内のディレクトリに配置されていません。wp が移動された場所を確認してください:
which wpコマンドが何も返さない場合、バイナリは PATH にありません。~/.bashrc または ~/.zshrc を編集して /usr/local/bin を PATH に追加してください:
export PATH="$PATH:/usr/local/bin"
source ~/.bashrc続いて wp --version を再試行してください。
PATH に PHP が見つからない (Windows / Cygwin)
WP-CLI はターミナルからアクセス可能な PHP を必要とします。Cygwin では php --version を実行して PHP がインストールされているかを確認してください。エラーが返る場合は、Cygwin インストーラを再実行して php パッケージを追加してください。
Phar ファイルでの Permission denied (Linux / macOS)
ファイルを /usr/local/bin に移動するときに「Permission denied」エラーが出る場合は、コマンドの前に sudo を付けてください:
sudo mv wp-cli.phar /usr/local/bin/wp(共有ホスティングなどで) sudo が使えない場合は、ファイルをユーザーが書き込み可能なディレクトリ (例: ~/bin/) に移動して、そのディレクトリを PATH に追加してください。
PHP バージョンの不一致
WP-CLI には PHP 5.4 以降が必要です。php --version を実行して、ターミナルが解決するバージョンを確認してください。複数の PHP バージョンがインストールされている場合、WP-CLI が拾うバージョンは PATH の順序によって決まります。多くの場合、最低要件である 5.4 を下回るバージョンの PHP を実行しているサーバーでこの問題が見られます。PHP を要件を満たすバージョンにアップグレードすれば解決します。PHP のインストールガイダンスは php.net/manual/en/install.php を参照してください。
まとめ
WP-CLI がインストールできたので、コマンドラインから WordPress サイトを管理する作業を始められます。コマンドリファレンスとハンドブックの全体は公式 WP-CLI ドキュメントで参照できます。
