WordPressのXMLインポートで画像を移行する方法|URL置換とuploads_old

こんにちは。いっきー(@ikirin_web)です。
WordPress改ざんからの復旧シリーズ、3記事目です。シリーズ全体の流れと、前回の記事はこちらです。
前回は、バックアップのデータベースをLocalで隔離して読み込み、XMLファイルとして書き出すところまでまとめました。
今回は、そのXMLのURLを本番用に置き換えてクリーンな本番環境へインポートする手順をまとめます。画像を一時的に置くuploads_oldというフォルダを使うのがポイントです。
uploads_oldは今回、画像の一時的な取得元として自分で作成したフォルダです。WordPressの標準機能で自動的に作られるフォルダではなく、名前自体に特別な意味はありません。
この記事は、私が実際に被害にあったときの対応をまとめた体験記です。被害の内容やサーバーの環境によって必要な対応は変わります。実際に対応するときは契約しているサーバー会社の案内を優先してください。
- uploads_oldの役割を理解する
- カスタム投稿タイプがある場合は、本番に器を用意する
- 本番にuploads_oldを作って画像を置く
- XMLのURLを置換する
- インポートの準備をする
- 本番でインポートを実行する
- インポート後の確認をする
uploads_oldの役割を理解する
XMLのままでは画像が取り込めない
WordPressのインポーターには、「添付ファイルをダウンロードしてインポートする」という機能があります。XMLに書かれた画像のURLにアクセスして画像をダウンロードし、メディアに登録してくれる機能です。
今回Localから書き出したXMLでは画像の取得元URLが次のようにLocalを向いていました。
http://example.local/wp-content/uploads/2025/03/sample.pngLocalのURLは自分のパソコンの中にしかないので、本番のサーバーからはアクセスできません。このままインポートしても画像は取り込めません。
本番に画像を一時的に置く
そこで本番のwp-contentの中にuploads_oldというフォルダを作り、バックアップの画像を一時的に置きました。XMLの画像URLをここに向けておけばインポーターが本番のURLから画像をダウンロードできます。
wp-content/
├── uploads/ ← インポーターが画像を登録する場所(最終的な置き場所)
└── uploads_old/ ← インポーターが画像を取りに行く場所(一時的な取得元)attachment_urlと本文の画像URLは役割が違う
XMLの中には画像のURLが大きく2種類あります。
<wp:attachment_url>:インポーターが画像をダウンロードしに行く取得元のURL →uploads_oldに向ける- 記事本文(
<content:encoded>)の中の画像URLは、最終的に使う本番ドメインのuploadsを参照するようにします。Localや旧ドメインのURLが残っている場合は、それぞれ確認して変更します。
XML全体をuploads_oldに一括置換してはいけません。置き換えるのは<wp:attachment_url>だけです。
1サイト目でやってしまった失敗
実は1サイト目では、XML全体をまとめてuploads_oldに置換してしまいました。
その結果、<wp:attachment_url>だけでなく、記事本文の画像URLまでuploads_oldになってしまいました。 このままでは、あとでuploads_oldを削除したときに記事の画像がすべて表示されなくなります。
このときはインポート後にBetter Search Replaceというプラグインで本文のURLをuploadsに戻して対応しました。
この失敗を踏まえて2サイト目以降は、最初から<wp:attachment_url>だけを置き換えるようにしました。その手順をこのあとまとめます。
カスタム投稿タイプがある場合は、本番に器を用意する
Custom Post Type UI(CPT UI)でカスタム投稿タイプを作っている場合は、XMLをインポートする前に本番にも同じ投稿タイプとタクソノミーを用意しておきます。
本番に同じカスタム投稿タイプが登録されていないと、その投稿がインポートされない場合があります。タクソノミーも含めてインポート前に同じ登録設定を用意しておきます。
CPT UIの設定を移す
CPT UIには設定を書き出して別のサイトに読み込む機能があります。
- LocalのCPT UI → ツール → 投稿タイプタブ の Export Post Types の中身をコピーする
- 本番にCPT UIをインストール・有効化 → ツール → 投稿タイプタブの 投稿タイプをインポート に貼り付けて インポート をクリック
- Localの タクソノミータブ の Export Taxonomies の中身をコピーする
- 本番の タクソノミータブ の タクソノミーをインポート に貼り付けて インポート をクリック
インポートできると本番の管理画面のメニューに、カスタム投稿タイプが表示されます。
ACFのフィールドグループ
Advanced Custom Fields(ACF)も、本番にインストール・有効化しておきます。
今回は、XMLのインポートでフィールドグループも一緒に移ってきました。ただ確実に移したい場合は、ACFの ツール からJSONを書き出して本番で読み込むのがACF公式の方法です。
インポート後に ACF → フィールドグループ を開き、なければJSONで移します。重複しないよう先にあるかどうかを確認してから読み込みましょう。
本番にuploads_oldを作って画像を置く
- エックスサーバーのファイルマネージャーで
wp-contentを開き、uploadsと同じ階層にuploads_oldフォルダを作る - 前回安全確認をした検証用コピーの
uploadsから、年別フォルダ(2016〜2026など)をFTPでuploads_oldへアップロードする
最初からuploadsに直接入れず、uploads_oldという別のフォルダに置くことでインポーターが登録する画像と混ざる事故を防げます。
XMLのURLを置換する
ここからは、VS Codeを使ってXMLのURLを置き換えていきます。
作業は必ずXMLの原本をコピーしたファイルで行います。置換を間違えても原本があればやり直せます。
以下は今回使用した検索式と置換文字列です。LocalのURLと本番ドメインは、ご自身の環境に合わせて変更してください。検索結果が想定した件数と異なる場合は、そのまま置換せずXMLの記述を確認してください。
①XMLをVS Codeで開く
コピーしたXMLファイルをVS Codeで開きます。
開いたときに「特殊な行の終端記号」についての警告が出ることがあります。その場合は「無視する」を選び、特殊な行の終端記号を削除するは押さないようにします。
②置換する前に件数を数える
置換する前に、検索(⌘ + F)で2つの件数を調べておきます。
<wp:attachment_url>の件数http://example.local/wp-content/uploads/の件数
私の場合は次のようになりました。
<wp:attachment_url>:281件http://example.local/wp-content/uploads/:282件
今回は件数に1件の差があったため該当箇所を確認しました。その結果、添付ファイルの取得元ではないロゴ画像のURLだと分かりました。
件数の差だけで用途は判断できないので検索結果を確認して、どこで使われているURLなのかを調べます。
③attachment_urlだけを置換する
VS Codeで⌘ + Option + Fを押して置換の画面を開き、検索欄の右にある .*(正規表現)をクリックしてON にします。
検索欄に、次の文字列を入力します。
(<wp:attachment_url><!\[CDATA\[)http://example\.local/wp-content/uploads/置換欄には、次の文字列を入力します。example.comの部分は、本番のドメインに変えてください。
$1https://example.com/wp-content/uploads_old/.*をONにしないと「結果はありません」と表示されます。ONにして検索結果が②で数えた<wp:attachment_url>の件数(今回は281件)になれば成功です。
$1は、検索欄のカッコで囲んだ部分(<wp:attachment_url><![CDATA[)をそのまま残すための書き方です。こうすることでタグを壊さずにURLだけを置き換えられます。
置換するときはいきなり全部を置換せず、まず1件だけ置換して結果を確認します。
<wp:attachment_url><![CDATA[https://example.com/wp-content/uploads_old/2025/03/sample.png]]></wp:attachment_url><wp:attachment_url><
