WordPressをコマンドラインで操作する
- 2019-11-25
- WordPressデザインレシピ集
- cli / wordpress / wp-cli
WordPressサイトをターミナルから操作するには、接続先サーバー(ローカルの場合はローカル)にwp-cliをインストールする必要がある。インストールは下記URL参照。phar経由でwp-cliインストールし、タブコンプリーションを有効化するにはwp-completion.shもダウンロードする。wp-completion.shはユーザーのホームディレクトリなどに保存しておく。
ヘルプ:
$ wp help # wp --helpでもよい
$ wp <command> help # wp <command> --helpでもよい eg. wp plugin --help
wp-cli自体をアップデートするには:
$ wp cli update
wp-cliバージョンの確認
$ wp cli version # インストールされているwp-cliのバージョンを確認
$ wp cli check-update # 新しいバージョンがないかどうか確認
WordPressコアのインストール/アップデート/バージョン確認などをするコマンド。コマンドを実行する前に、インストールするならインストールディレクトリに、アップデートやバージョン確認をする場合はインストールされているディレクトリにcd
で移動しておく。
WordPressコアのバージョンを確認するには:
$ cd /path/to/wordpress
$ wp core version
コアにアップデートがあるかどうか:
$ wp core check-update
Success: WordPress is at the latest version.
コアをアップデートするには:
$ wp core update
プラグインのインストールやアップデート、有効化/無効化の設定をするコマンド。下記のコマンドでプラグイン名を入力する場合(<plugin_name>
)、半角スペース区切りで複数指定できる。
インストールされているプラグインの確認:
$ cd /path/to/wordpress
$ wp plugin list
…上記コマンドを実行すると、インストールされているプラグインの有効・無効、最新バージョンかどうかを確認できる一覧表が出てくる。特定のプラグインをアップデートする場合は:
$ wp plugin update <plugin_name>
最新でないプラグインをすべてアップデートする場合は:
$ wp plugin update --all
プラグインを探す:
$ wp plugin search <plugin-name>
プラグインをインストール:
$ wp plugin install <plugin-name>
特定のプラグインを有効化するには:
$ wp plugin activate <plugin_name>
特定のプラグインを無効化するには:
$ wp plugin deactivate <plugin_name>
特定のプラグインを削除するには:
$ wp plugin deactivate <plugin_name>
$ wp plugin delete <plugin_name>
キャッシュを管理するコマンド。
キャッシュをクリアするには:
$ wp cache flush
テーマを管理するコマンド。
インストールされているテーマを一覧表示する。現在アクティブなテーマを確認するときもこのコマンドを使う。
$ wp theme list
特定のテーマをアップデートするには:
$ wp theme update <theme_name>
最新でないテーマをすべてアップデートするには:
$ wp theme update --all
インストールされているテーマを有効化するには:
$ wp theme activate <theme_name>
データベースの操作をするコマンド。基本の操作だけができる。
データベースの現在のステータスを確認するには:
$ wp db check
データベースを更新する:
使ったことない(コマンドラインからWordPress本体をアップデートするとデータベースも更新されるのかな?
$ wp core update-db
翻訳ファイルを管理・インストールするコマンド。
全翻訳ファイルをリストするには:
$ wp language core list
ただし、wp language core list
ではインストールされていない翻訳ファイルもすべてリストされるため結果が見づらくなる。
インストールされている翻訳ファイルだけをリストするには(日本語サイトの場合は通常en_US
英語翻訳ファイルがリストされる):
$ wp language core list --status=installed
アクティブな翻訳ファイルだけをリストするには(日本語サイトの場合は通常ja
日本語翻訳ファイルがリストされる):
$ wp language core list --status=active
単に翻訳ファイルにアップデートがあるかどうかを確認したいときはdry-run
オプションをつける:
以下のコマンドはwp language core update
コマンドを実行したらどの翻訳ファイルがアップデートされるかを一覧表示してくれる。実際にはファイルがインストールされることはない。
$ wp language core update --dry-run
Found 1 translation update that would be processed:
+------+-----------+---------+----------+
| Type | Name | Version | Language |
+------+-----------+---------+----------+
| Core | WordPress | 5.1 | Japanese |
+------+-----------+---------+----------+
更新された翻訳ファイルを実際にアップデートするには:
$ wp language core update