WP-CLIの確認コマンドと変更コマンドの区別(option・post・plugin・theme・eval-file・search-replace)

要点

WP-CLIは「見るだけ」のコマンド(get・list)と「変える」コマンド(update・delete・activate・search-replace本番・eval-file)がある。必ず確認コマンドで現在値を控えてから、バックアップを取り、変更は1つずつ。eval-fileはスクリプトの中身次第で書き込むので変更扱い。

guidepocket.net での実際の接続・読み取り例は よく使うコマンド集(PowerShell・Claude Code起動・knowledge・WP-CLI・SSH)、公開の流れは cc-wp-cli-pipeline。

基本の考え方

  1. 読み取りだけの確認から始める(何が今どうなっているか)。
  2. 変更する値の現在値をファイルに控える。
  3. バックアップ(WordPressのバックアップ対象と種類の使い分け(DB・wp-content・フル/DBのみ/差分・世代管理)と「戻せるか」の確認)。
  4. 変更コマンドを1つずつ実行。
  5. もう一度確認コマンドで結果を見る。

--skip-plugins --skip-themes を付けると、プラグインの不具合や副作用を避けて実行できる(プラグイン自体の情報を見るときは結果が変わることがある)。

確認コマンド(読み取りのみ)

wp core version
wp option get siteurl
wp option get home
wp option get blog_public
wp post list --post_type=page --fields=ID,post_title,post_name,post_status --format=table
wp post get <ID> --fields=ID,post_title,post_status,post_parent
wp post meta get <ID> <メタキー>
wp plugin list --fields=name,status,version,update
wp theme list
wp user list --fields=ID,user_login,roles
wp search-replace 'http://old' 'https://new' --dry-run      # 件数だけ確認(書き込まない)

変更コマンド(書き込む)

コマンド何が変わるか事前にすること
wp option update <名前> <値>サイト設定wp option get で現在値を控える
wp post update <ID> --post_status=publish など投稿・ページwp post get で現在値、ページのバックアップ
wp post delete <ID>ページ削除(--force でゴミ箱を経由しない)原則使わない。必要ならゴミ箱止まり
wp plugin activate / deactivate / update / deleteプラグイン一覧の控え、バックアップ、動作確認計画
wp theme activate / updateテーマ同上
wp search-replace <旧> <新>(dry-runなし)DB全体の文字列DBバックアップ、dry-runで件数確認
wp eval-file <スクリプト>スクリプトの中身次第(何でもできる)中身を読んで書き込みの有無を確認。書き込むなら DRY モードを用意(安全な変更の流れ(バックアップ→DRY RUN→本番反映→検査→復旧手段の確認))
wp db importDB全体を置き換え現在のDBのバックアップ必須
wp cache flushオブジェクトキャッシュ削除影響は小さいが本番では意図して実行

wp db export <ファイル> はDBを読み取ってファイルに書き出す(サイトは変わらない)。出力先は公開ディレクトリの外にする。

注意点

コピペ用: 状況確認セット(読み取りのみ)

wp core version --skip-plugins --skip-themes
wp option get home --skip-plugins --skip-themes
wp option get blog_public --skip-plugins --skip-themes
wp plugin list --fields=name,status,version,update --skip-plugins --skip-themes
wp theme list --skip-plugins --skip-themes
wp user list --fields=ID,user_login,roles --skip-plugins --skip-themes
wp post list --post_type=page --post_status=any --fields=ID,post_title,post_status,post_parent --format=csv --skip-plugins --skip-themes
wp post list --post_type=page --post_status=draft --format=count --skip-plugins --skip-themes
wp post get <ID> --fields=ID,post_title,post_name,post_status --skip-plugins --skip-themes
wp db size --human-readable --skip-plugins --skip-themes

変更系(option update post update eval-file など)は、上の確認で対象を特定し現在値を控え、バックアップを取ってから1つずつ(上の「変更コマンド」表)。