WordPressのURL変更を試す|本文・シリアライズ値・GUIDの照合
このページの目次(6 項目)
WordPressのドメインや公開パスを変えるときは、管理画面のURL設定に加えて、本文内の画像リンクやプラグインの設定も確認します。一括置換を使うなら、どの値が変わり、何を維持するかを先に決めます。
今回のコピー環境では、WP-CLIの試行前後でDBの照合値は変わらず、実行後は本文と設定のURLが変わりました。 GUIDと画像ファイルは維持できています。これは本番へ反映する前に、変更範囲を確かめる一例です。
DNSの変更とDB内のURL変更を分ける
今回の試験では、同じPC内の別ポートを移行前後のURLにしました。DNSの設定は変更していません。URLが同じままVPSの接続先だけを替える移行では、同じ一括置換が必要とは限りません。
ドメインやパスを替える場合は、home・siteurl、本文の画像URL、設定に保存されたURLを棚卸しします。WordPress本体が管理するテーブル以外に、独自の保存先がないかも確認してください。
- 変更前のDBと照合値を保存
- dry-runで対象を確かめる
- 実行後の本文・設定・GUIDを照合
dry-runで内容が変わらないかを比べた
固定したDBを復元するたびに、--dry-runを付けた置換を行い、試行の前後で照合値を比較しました。対象は合成投稿100件と、画像、役割、設定です。
2026年10月18日のローカル試験です。Windows上のDocker Desktopを使用し、合成投稿100件・小さなPNG画像12枚で確認しました。実VPSや本人の環境の結果ではありません。
| 確認したこと | 試行数 | 観測した結果 |
|---|---|---|
| URL置換の試行でDBを変えない | 3回 | 試行後も元の値が一致 事前に定めた判定と一致 |
| シリアライズ値と画像URLを置換しGUIDは維持 | 3回 | 設定と本文のURLを変更、GUIDと画像を維持 事前に定めた判定と一致 |
- URL置換の試行でDBを変えない
試行数:3回
試行後も元の値が一致
事前に定めた判定と一致 - シリアライズ値と画像URLを置換しGUIDは維持
試行数:3回
設定と本文のURLを変更、GUIDと画像を維持
事前に定めた判定と一致
本実行では--skip-columns=guidを指定しました。本文内に元のURLが残っていないこと、配列に保存した設定URLを読み戻せること、GUIDと画像のハッシュが変わらないことを確認しています。
使用したオプションとシリアライズ値の扱いは、WP-CLIのsearch-replace公式説明を確認しました。今回は対象を把握した単一サイトです。マルチサイトや独自テーブルまで同じ範囲で処理できたという結果ではありません。
長さの異なるURLでも設定を読み戻す
ポート番号だけの変更では、URLの文字数が同じです。それだけでは、文字列の長さを保存するシリアライズ形式への対応を十分に確かめられません。そこで別の配列設定を作り、長いパスのURLへ置換しました。
2026年10月18日のローカル試験です。Windows上のDocker Desktopを使用し、合成投稿100件・小さなPNG画像12枚で確認しました。実VPSや本人の環境の結果ではありません。
| 確認したこと | 試行数 | 観測した結果 |
|---|---|---|
| 長さの違うURLをシリアライズ値へ置換 | 3回 | 長いURLへ変更後も配列として読戻し、日本語・絵文字を維持 事前に定めた判定と一致 |
- 長さの違うURLをシリアライズ値へ置換
試行数:3回
長いURLへ変更後も配列として読戻し、日本語・絵文字を維持
事前に定めた判定と一致
置換後も配列として読み出せ、新しいURLと日本語・絵文字の値が一致しました。この試験は設定値の置換です。長いパスにWordPressを設置し、ログインや全ページを表示できたという意味ではありません。
自分のサイトでは戻せるコピーで範囲を絞る
実行前のDBを残し、本番と分離したコピーで対象を確認します。次はオプションの使い方を示す入力例です。今回の実行コマンドをそのまま本番向けにしたものではありません。
wp search-replace 'https://old.example' 'https://new.example' \
--skip-columns=guid --dry-run
置換の対象テーブル、列、元の文字列を確認した後に、本実行するかを判断します。対象が想定より広い、設定を読み戻せない、本文が変わるなどの問題があれば、保存したDBへ戻して原因を調べます。
公開前に残るのはHTTPSと転送、実際の操作
今回、ローカルで復元したトップページと元画像を取得しています。公開DNS、証明書の発行・更新、HTTPSのループ、古いドメインからの転送、長い公開パスでのログインや、ブロックエディターのUI操作は、この結果の範囲外です。
公開経路の確認はDNS・HTTPS・URL切替のガイドへまとめています。URLを変えずにVPSだけを替える場合も、移行リハーサルで新側へ接続し、内容を照合しておきます。
URLを変える前のコピーは、本番と別のVPSでも作れます。時間課金なら、HTTPSや転送の確認が終わったら削除できます。
ConoHa VPSは新規受付を一時停止中です
2026年11月14日から、新しい申し込みを受け付けていません。再開の日は決まっておらず、公式のお知らせで案内されます(2026年11月15日確認)。ConoHa VPS公式のお知らせ
これから新しくVPSを借りる場合は、各社の受付状態を2GB VPSの比較で、時間課金や短い契約で借りたときの費用を契約期間ごとの料金の記事で確かめてください。
確認範囲と更新履歴
2026年10月18日に合成データのコピーで実行しました。通常のURL変更は保存点から3回やり直し、長いURLへの配列設定の置換も3回実行しています。一般のプラグイン、独自テーブル、マルチサイト、正規表現置換、公開ドメインの移転は確認していません。
- 2026年10月18日:dry-run、本文と配列設定の置換、GUID維持、長さの異なるURLの照合を公開。
- 2026年10月21日:申込先へのリンクを追記。