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。
基本の考え方
- 読み取りだけの確認から始める(何が今どうなっているか)。
- 変更する値の現在値をファイルに控える。
- バックアップ(WordPressのバックアップ対象と種類の使い分け(DB・wp-content・フル/DBのみ/差分・世代管理)と「戻せるか」の確認)。
- 変更コマンドを1つずつ実行。
- もう一度確認コマンドで結果を見る。
--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 import | DB全体を置き換え | 現在のDBのバックアップ必須 |
wp cache flush | オブジェクトキャッシュ削除 | 影響は小さいが本番では意図して実行 |
wp db export <ファイル> はDBを読み取ってファイルに書き出す(サイトは変わらない)。出力先は公開ディレクトリの外にする。
注意点
- 対象のWordPressディレクトリにいるか確認(
pwd、wp option get home)。同じサーバーに複数サイトがあると、別サイトを変えてしまう。 search-replaceはシリアライズデータを正しく扱える。SQLの直接置換はしない(WordPressのURL変更・ドメイン変更(サイトアドレス・DB内URL・シリアライズ・301・canonical・Search Console・GA4・メール))。- guidepocket.net では blog_public・プラグイン・テーマ・設定の変更は禁止(gp-noindex-rule、guidepocket.net 制作ルール(CLAUDE.md・ページ作成ルール・文章ルールの要点))。
コピペ用: 状況確認セット(読み取りのみ)
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つずつ(上の「変更コマンド」表)。