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

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

こんにちは。いっきー(@ikirin_web)です。

WordPress改ざんからの復旧シリーズ、3記事目です。シリーズ全体の流れと、前回の記事はこちらです。

前回は、バックアップのデータベースをLocalで隔離して読み込み、XMLファイルとして書き出すところまでまとめました。

今回は、そのXMLのURLを本番用に置き換えてクリーンな本番環境へインポートする手順をまとめます。画像を一時的に置くuploads_oldというフォルダを使うのがポイントです。

uploads_oldは今回、画像の一時的な取得元として自分で作成したフォルダです。WordPressの標準機能で自動的に作られるフォルダではなく、名前自体に特別な意味はありません。

この記事は、私が実際に被害にあったときの対応をまとめた体験記です。被害の内容やサーバーの環境によって必要な対応は変わります。実際に対応するときは契約しているサーバー会社の案内を優先してください。

  1. uploads_oldの役割を理解する
  2. カスタム投稿タイプがある場合は、本番に器を用意する
  3. 本番にuploads_oldを作って画像を置く
  4. XMLのURLを置換する
  5. インポートの準備をする
  6. 本番でインポートを実行する
  7. インポート後の確認をする

uploads_oldの役割を理解する

XMLのままでは画像が取り込めない

WordPressのインポーターには、「添付ファイルをダウンロードしてインポートする」という機能があります。XMLに書かれた画像のURLにアクセスして画像をダウンロードし、メディアに登録してくれる機能です。

今回Localから書き出したXMLでは画像の取得元URLが次のようにLocalを向いていました。

  http://example.local/wp-content/uploads/2025/03/sample.png

Localの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には設定を書き出して別のサイトに読み込む機能があります。

  1. LocalのCPT UI → ツール → 投稿タイプタブ の Export Post Types の中身をコピーする
  2. 本番にCPT UIをインストール・有効化 → ツール → 投稿タイプタブの 投稿タイプをインポート に貼り付けて インポート をクリック
  3. Localの タクソノミータブ の Export Taxonomies の中身をコピーする
  4. 本番の タクソノミータブ の タクソノミーをインポート に貼り付けて インポート をクリック

インポートできると本番の管理画面のメニューに、カスタム投稿タイプが表示されます。

ACFのフィールドグループ

Advanced Custom Fields(ACF)も、本番にインストール・有効化しておきます。

今回は、XMLのインポートでフィールドグループも一緒に移ってきました。ただ確実に移したい場合は、ACFの ツール からJSONを書き出して本番で読み込むのがACF公式の方法です。

インポート後に ACF → フィールドグループ を開き、なければJSONで移します。重複しないよう先にあるかどうかを確認してから読み込みましょう。

本番にuploads_oldを作って画像を置く

  1. エックスサーバーのファイルマネージャーでwp-contentを開き、uploadsと同じ階層にuploads_oldフォルダを作る
  2. 前回安全確認をした検証用コピーの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><![CDATA[が壊れていない
  • https://本番のドメイン/wp-content/uploads_old/になっている
  • 後ろの2025/03/sample.pngの部分が残っている

この3点が問題なければ「すべて置換」をクリックします。

④置換できたか確認する

検索欄で次の2つを調べます。

  • http://example.local/wp-content/uploads/ → 今回は事前に確認したロゴ画像のURLが1件残っていました。(②で見つけたロゴ画像)ご自身のXMLでは置換前に確認した内容と一致しているかを確認してください。
  • /wp-content/uploads_old/ → 281件(②の<wp:attachment_url>と同じ件数)になっていればOK

⑤添付ファイル以外に残った画像URLを変更する【今回はロゴ画像1件】

残った1件(ロゴ画像)は手で本番のuploadsのURLに書き換えます。

  • 変更前:http://example.local/wp-content/uploads/...
  • 変更後:https://example.com/wp-content/uploads/...

⑥残りのLocalのURLを本番のドメインに置換する

最後に記事内のリンクなどに残っているLocalのURLを、まとめて本番のドメインに置き換えます。正規表現の.*はOFFに戻しておきます。

  • 検索:http://example.local
  • 置換:https://example.com

置換したら、もう一度件数を確認します。

検索する文字列正しい件数
example.local0件
/wp-content/uploads_old/<wp:attachment_url>と同じ件数

これでインポート用のXMLができました。

インポートの準備をする

PHPの実行時間を延ばす

画像が多いとインポートに時間がかかります。途中で処理が止まらないようにPHPの実行時間を延ばしておきます。

  1. エックスサーバーの サーバー管理 → PHP → php.ini設定 を開く
  2. 対象のドメインの 詳細設定 をクリック
  3. その他の設定 のmax_execution_timeを180から300に変更して 設定する をクリック

Basic認証を一時的に外す

インポーターは、uploads_oldの画像にURLでアクセスしてダウンロードします。Basic認証がかかっているとインポーターも画像にアクセスできません。

そこでインポートの間だけ、Basic認証を外します。

  • サーバー管理 → ホームページ → アクセス制限 で、対象のドメインを OFF にする

Basic認証を外している間はサイトが誰でも見られる状態になります。インポートが終わったら、すぐにONに戻しましょう。

本番でインポートを実行する

  1. 本番の管理画面で ツール → インポート を開き WordPress の 今すぐインストール をクリック
  2. インポーターの実行 をクリック
  3. URLを置換したXMLファイルを選び ファイルをアップロードしてインポート をクリック
  4. 投稿者の割り当てを設定する
  5. 添付ファイルをダウンロードしてインポートする にチェックを入れる
  6. 実行 をクリック

投稿者の割り当ては、本番で新しく作った管理者ユーザーにまとめて割り当てました。旧サイトのユーザーを新しく作らないためです。

一度インポートしたあとにインポートをやり直す場合は、まず現在どこまで取り込まれているかを確認します。再実行時に既存の投稿として判定されるものもあるため必ず重複するとは限りません。

一方で、途中まで取り込まれたメディアや関連情報が残る場合もあります。投稿だけを削除すれば最初の状態に戻るわけではないためバックアップを確保したうえで、やり直す方法を検討してください。

504・503エラーが出たときの対処

画像が多いサイトでは、インポート中に504・503エラーが表示されました。ただ、エラー画面になってもサーバー側の処理が続いている場合がありました。

私の場合は次のような経過でした。

  1. インポーターの画面が504エラーになったものの別タブで確認するとメディア件数は増えていたため、そのまま待ちました。
  2. メディア件数が増えなくなって5分以上たったところで504の画面を一度リロードしました。
  3. その後、再びメディア件数が増え始めました。今度は503エラーが表示されたため、さらに5〜10分ほど待ちました。
  4. 最終的に、投稿・固定ページ・コメント・カテゴリー・タグなどが取り込まれたことを確認しました。

ただし、リロードで処理が再開したのか同じ処理が再送信されたのかは確認できていません。今回の経過を「5分待ってリロードすればよい」という手順として勧めるものではありません。

再実行する前には、投稿やメディアの取り込み状況とエラーの内容を確認してください。

画像が約2,000件のサイトではこのように時間がかかりましたが、約280件のサイトではエラーも出ずに取り込みが完了しました。

インポート後の確認をする

インポートが終わったら次の順番で確認します。

  1. Basic認証をONに戻す
  2. 投稿・固定ページ・カテゴリー・タグ・メディアの件数をLocalと比べる
  3. 記事内の画像とアイキャッチが表示されているかを確認する
  4. カスタム投稿タイプを使っている場合は記事の一覧やタクソノミー、ACFの入力値も確認する

uploads_oldはインポートが終わってもすぐには削除しません。画像が表示されないなどの問題があったときに元の画像と照らし合わせるために使います。

実際に私の場合はメディアの件数がLocalと合わなかったり、記事内の画像が表示されなかったりする問題が起きました。その調査と対処は次の記事でまとめます。

まとめ

この記事では、XMLのURLを置換して本番環境へインポートするまでをまとめました。

  • 画像は本番のuploads_oldに一時的に置きインポーターに取りに行かせる
  • XML全体ではなく<wp:attachment_url>だけをuploads_oldに置換する
  • 置換の前後で件数を数えて正しく変わったかを確かめる
  • カスタム投稿タイプはインポートの前に本番に器を用意する
  • 504・503エラー時はむやみに再実行せずメディア件数の変化などから取り込み状況を確認する

次の記事では、インポート後に記事内の画像が表示されなかった原因と直し方をまとめます。

最後まで読んでいただきありがとうございます。

ページトップへ戻る