WordPressのURL変更・ドメイン変更(サイトアドレス・DB内URL・シリアライズ・301・canonical・Search Console・GA4・メール)

要点

WordPressアドレス・サイトアドレスを変え、DB内の旧URLは wp search-replace(dry-run→本番)で置換、旧URLから新URLへページ単位で301。SQLの単純置換はシリアライズデータを壊す。Search Console・GA4・外部サービス・メールアドレスの変更も忘れない。

変える場所

場所内容
WordPressアドレス(siteurl)・サイトアドレス(home)設定 → 一般、または wp option update。間違えると管理画面に入れなくなるので、現在値を控えてから
DB内の内部URL・画像URL本文・Elementorデータ・ウィジェット・カスタマイザーに旧URLが直書きされている
テーマ・CSS・JSのファイル内直書きのURL
リダイレクト旧URL → 新URL をページ単位で301(HTTPステータスとリダイレクトの基本(200・301・302・404・410・403・500・503))。全部トップへ飛ばさない
canonical・サイトマップ・OGPSEOプラグインが新URLで出しているか
Search Console新ドメインのプロパティ登録、ドメイン変更なら「アドレス変更」ツール、サイトマップ再送信(Search Consoleの登録と日常の使い方(プロパティ・所有権確認・サイトマップ・URL検査・検索パフォーマンス))
GA4データストリームのURL、クロスドメイン設定、参照元除外(GA4の導入と最初の設定(タグ設置・二重計測防止・自分のアクセス除外・保持期間))
外部サービスフォーム・決済・予約・API・SNSプロフィール・広告のリンク先・Googleビジネスプロフィール・名刺・印刷物
メールドメインを変えるならメールアドレスも変わる。旧ドメインのメールをいつまで受けるか、転送を決める(メールの仕組みとDNS(MX・SPF・DKIM・DMARC・SMTP・IMAP・POP)と「Webだけ移転」で止まるメール事故)
SSL新ドメインの証明書(SSL/HTTPSの基本と「保護されていない通信」・Mixed Contentの直し方(証明書・Let's Encrypt・自動更新・http→https))

DB内URLの置換(WordPress特有の注意)

  • WordPressは設定やウィジェットをシリアライズ(s:20:"https://example.com/" のように文字数付き)で保存している。SQLやテキストエディタで単純に文字列置換すると、文字数が合わなくなりデータが壊れる(ウィジェットが消える、設定が初期化される)。
  • wp search-replace を使う(シリアライズを正しく扱う)。
wp db export before-url-change.sql            # 公開ディレクトリの外へ
wp search-replace 'https://old.example' 'https://new.example' --dry-run --skip-columns=guid
wp search-replace 'https://old.example' 'https://new.example' --skip-columns=guid
  • Elementor はデータ内でURLを https:\/\/old.example のようにエスケープして保存することがある。通常の置換で拾えない分は Elementor のURL置換ツールを使う(名称は版で要確認)。
  • 置換文字列は末尾まで正確に(old.example だけだと old.example.jp なども変わる)。
  • 置換後はキャッシュ・Elementor CSSの再生成(WordPressの変更が反映されない(キャッシュの種類と消し方))。

確認

  • 旧URLの代表ページが新URLへ301で飛ぶ、新URLが200。
  • ページ内に旧ドメインが残っていないか(ソースを検索)。Mixed Content がないか。
  • フォーム送信・メール・ログイン。
  • 数週間は Search Console で新旧のインデックス状況を見る。旧ドメインは更新を止めずに(期限切れにせず)リダイレクトを長期間維持する。