サーバー上のWP-CLIを最新版にアップデートする

サーバーにインストール済みのWP-CLIを最新版にアップデートする手順の備忘録。

今回はエックスサーバーに手動でインストールしたWP-CLIを対象とする。PHPのバージョン変更後、古いWP-CLIでエラーが発生したため更新した。

WP-CLIのインストール手順については、以下の記事を参照。

• エックスサーバーにWP-CLIをインストールする

現在はエックスサーバーでは、標準でWP-CLIがインストールされているため、手動でインストールする必要はない。

エラー例

古いWP-CLIをPHP8系で実行したところ、今回は以下のようなエラーが発生した。

PHP Fatal error: Uncaught TypeError: implode(): Argument #2 ($array) must be of type ?array, string given

これは古いWP-CLIが使用している implode() の引数の指定方法が、PHP 8.0以降ではサポートされなくなったことによるもの。

WP-CLIのバージョンを確認

SSHでサーバーに接続し、現在のバージョンを確認する。

wp --version

今回の環境では以下のバージョンだった。だいぶ古い。

WP-CLI 2.0.1

ただし、エラーが出ている場合、wp --version 自体が正常に実行できないこともある。

最新版のリリース情報

• Releases · wp-cli/wp-cli

WP-CLIを最新版に更新する

今回はWP-CLIを ~/bin/wp-cli.phar に配置し、.bashrc に以下のエイリアスを設定している。

alias wp='/usr/bin/php8.3 ~/bin/wp-cli.phar'

PHPの実行パスやWP-CLIの配置先は、各自の環境に合わせて読み替える。

1. 既存ファイルをバックアップ

更新前のWP-CLIをバックアップする。

cp ~/bin/wp-cli.phar ~/bin/wp-cli.phar.bak

2. 最新版をダウンロード

WP-CLI公式の配布先から最新版を取得する。

curl -fL https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar -o ~/bin/wp-cli-new.phar

• Installing | WP-CLI | WordPress.org

既存ファイルを直接上書きせず、別名で保存する。

3. 新しいWP-CLIの動作を確認

/usr/bin/php8.3 ~/bin/wp-cli-new.phar --info

WP-CLIのバージョン、PHPのバージョン、PHP binaryなどが表示されることを確認する。

4. 既存ファイルを置き換える

問題がなければ、新しいファイルで置き換える。

mv ~/bin/wp-cli-new.phar ~/bin/wp-cli.phar

5. 更新後の動作確認

wp --versionwp --info

正常にバージョン情報が表示されれば更新完了。