wp-cliのglobalパラメータ／YAMLコンフィグのオプション ( WP-CLI Advent Calendar 2014 5日目 )

WP-CLI アドベントカレンダー 2014 の第5日目！昨日の @wokamoto さんによる Chef で wp-cli を管理するためのレシピ | dogmap.jp に続きまして、頑張らせていただきます！

グローバルなパラメータ？

wp-cli には、すべてのコマンドと一緒に使うことができるグローバルパラメータというものがあり、 Configuration | WP-CLI のページで解説されています。

たとえば、以下のコマンドは WordPress がインストールされているパスを指定する --path というパラメータをつけています。

$ wp option get home --path=/var/www/vhosts/example.com/

wp option get home は、 WordPress の home_url( '/' ); が返す値を得るためのコマンドです。通常、 wp-cli は WordPress がインストールされているディレクトリ以下でなければ使えませんが、 --path=/path/to/wp/ をつけることで、ターミナルでそこまで移動していってコマンドするのと同じことになります。移動の手間が省けるだけではなく、複数の処理にまとめるときだとか、cronで実行するときなどに便利です。

そこで今日は、

1. グローバルパラメータの種類
2. これらのパラメータは設定ファイルにも書いて置いておくことができるのだが、その優先順位

について書きたいと思います。

設定ファイルについてはどなたかがこのリレーブログの中で誰かが書いてくれるであろうことを期待しております。誰も書かなければ来週も私なので書こうと思います。

グローバルパラメータの種類

$ wp core config --prompt
1/10 --dbname=: hello
2/10 --dbuser=: hey
3/10 [--dbpass=]: pass
4/10 [--dbhost=]: :)
5/10 [--dbprefix=]: (๑╹ڡ╹๑)
6/10 [--dbcharset=]: nyoro
7/10 [--dbcollate=]: asdf
8/10 [--locale=]: 123
9/10 [--extra-php] (Y/n): n
10/10 [--skip-salts] (Y/n): n

パラメータを指定する際の（指定方法の）優先順位

パラメータの指定は、コマンドと一緒に --example=example という形でつけるだけではなく、.ymlファイルに設定を書いておくことでも可能です。

たとえば、wp-cli.yml というファイルが置いてあるとして、その内容が、 skip-plugins: akismet backwpup third fourth の一行であったとすると、このファイルが設置されている場所以下でのコマンドに、この内容が反映され、指定されたプラグインは無いものとしてコマンドが実行されます。

ymlファイルの置き場所は複数ありますので、それらの優先順位をこれまた同じページからですが、日本語にしておきます。優先順位の高い順位、

1. コマンドラインからフラグを付けて指定する
2. wp-cli.local.yml ファイル内の指定。
3. wp-cli.yml ファイル内の指定内容。
4. ~/.wp-cli/config.yml ファイル内の指定内容。（パスは環境変数 WP_CLI_CONFIG_PATH で変更が可能）
5. デフォルト値

この優先順位の利用方法としては、たとえばローカル環境にたくさんのWordPressがいるとして、

• どのプロジェクトでも使いたい設定については ~/.wp-cli/config.yml に。
• 特定のプロジェクトだけで利用したい設定については wp-cli.yml に。
• 特定のプロジェクトで、ローカルだけで利用したい設定については wp-cli.local.yml に書いて .gitignore に記載。

といった形にしておくと、細かいことを気にしないで短いコマンドを使うことができるかと思います。忘れると面倒だけど。

というわけで、本日はグローバルなパラメータがあったんだ！ということで、何かの時に思い出していただければと思います。

明日は、yuji.takehiro さんです！（明日、リンクします！）