【ITニュース解説】I built a WordPress migration tool that checks its own work

WordPressという人気の高いウェブサイト構築ツールから、別のシステムやCMS（コンテンツ管理システム）へサイト全体を移行する作業は、見た目以上に複雑で困難なことが多い。多くの移行ツールは「エクスポートが完了しました」と表示するが、それは単にファイルが出力されただけであり、本当にすべての情報が正しく移行されたのか、欠落や破損がないかまでは保証されない。例えば、すべての記事が移行されたか、画像はすべて正しい場所に表示されているか、古いURLをクリックしたときに新しいサイトの適切なページにたどり着くか、といった重要な点が抜け落ちている可能性がある。この「完了」と「完全」の間に存在するギャップが、移行作業を終えた後の大きな課題となるのである。

実際に、WordPressの移行作業でどのような問題が発生しているのかを明らかにするために、開発者は人気のある四つのWordPressエクスポートツールのGitHub上の課題報告を三百件収集し、内容を分析した。その結果、実に二七パーセントもの問題が、ツールそのものがクラッシュしたり、処理がタイムアウトしたり、あるいはツールのインストール自体に失敗するといった、基本的な動作の不安定さに関わるものであった。また、一四パーセントは画像が正しく移行されない問題、一二パーセントはURLやパーマリンク（記事の恒久的なアドレス）の扱いにまつわる問題、そして一〇パーセントはHTMLで書かれた内容が、Markdownという別の記述形式に変換される際に壊れてしまうという問題であった。さらに、ウェブ開発者や技術者が集まるHacker Newsというコミュニティで、WordPressからの移行に関するスレッド六百三十九件のコメントを読み込んだところ、百十一件もの具体的な困難が報告されていた。これらの中で特に多かったのは、移行後のサイト構築やデプロイ（公開）作業の煩雑さ、記事に寄せられたコメントの喪失、コンテンツを適切に取り出すことの難しさ、そして非開発者（専門知識を持たない一般ユーザー）が移行後にコンテンツを編集する能力を失ってしまうこと、といった課題であった。

こうした多くの課題を解決するために開発されたのが「wp-move」という新しいWordPress移行ツールである。このツールは、これまでのツールが抱えていた「移行完了＝完全な移行」ではないという根本的な問題を克服することを目指している。wp-moveの最大の特徴は、コンテンツの読み込みにWordPressが提供するREST API（ウェブサービス間でデータをやり取りするための規約）を利用する点にある。これにより、データベースに直接アクセスするよりも安全かつ標準的な方法でデータを取り出すことが可能となる。また、このツールはWordPressサイトからデータを「読み込む」ことのみを行い、サイトのデータに「書き込む」ことは一切しないため、元のWordPressサイトに予期せぬ変更が加えられる心配がないという安全性も考慮されている。

具体的にwp-moveがどのような機能を提供するのかを詳しく見ていこう。まず、wp-moveはWordPressサイトの投稿、固定ページ、メディア（画像や動画）、カテゴリ、タグといった主要なコンテンツをREST APIを通じて読み込む。次に、それぞれの投稿コンテンツをMarkdown形式に変換し、フロントマターと呼ばれる、記事のタイトルや作成日などのメタデータ情報を付加する。Markdown形式で表現しきれない複雑なHTML要素（例えば、テーブルや埋め込みコンテンツ、フォームなど）はHTMLのまま保持され、リスト化されるため、後から手動で確認・修正するべき箇所が明確になる。ウェブサイト上でホストされている画像ファイルについては、wp-moveがそれらを自動的にダウンロードし、新しいサイトの構造に合わせて画像へのパス（場所を示す情報）を書き換える処理を行う。これにより、移行後に画像が表示されないという問題を回避する。

さらに、wp-moveは移行元のWordPressサイトの古いURLと、新しいサイトでの対応するパスをマッピングする機能も備えている。このマッピング情報に基づき、サイトのリダイレクト設定ファイル（例えば、ウェブサーバーで使われるnginx用の設定ファイルや、Netlifyなどのホスティングサービスで利用される_redirectsファイル）を自動的に生成する。これにより、古いURLにアクセスしたユーザーを新しいサイトの適切なページに自動的に転送させることができ、SEO（検索エンジン最適化）への悪影響を最小限に抑えることが可能となる。そして、このツールの最も革新的な機能は「自己チェック」にある。wp-moveは移行作業の最終段階で、report.htmlとreport.jsonという形式で詳細なレポートファイルを出力する。このレポートには、移行された投稿、メディア、画像への参照、そして内部リンクに欠落がないかが詳細に記載される。もし一つでも欠落が見つかった場合、wp-moveは終了コード「2」という特定のコードと共に処理を終了する。これにより、開発者やユーザーは、見た目上の「完了」ではなく、本当に「完全」な移行が達成されたのかを、ツールの終了コードやレポートを通じて明確に把握できるようになる。

開発者がローカル環境にセットアップしたWordPress 7.1.3と公式のテーマテストデータを使用して、wp-moveのデモンストレーションを行った結果は、その有効性を明確に示している。合計百四十四件の投稿と固定ページ（ドラフトや公開予定の記事も含む）が完全に移行され、三十七件すべてのメディアファイルも正確に処理された。さらに、移行されたページの中に、元のテキストの九十五パーセント未満になったもの、画像が欠落したもの、または内部リンクが壊れているものは一つも存在しなかった。また、百六十四件すべての古いURLが新しいパスへnginx経由で正しくリダイレクトされることも確認された（URLのスタイル設定によっては二百八十二件すべてが正しくリダイレクトされた）。このテストの後、開発者は意図的に移行済みサイトから画像ファイルを一つ、投稿記事を一つ削除し、再度wp-moveを実行した。すると、レポートは百四十四件中百四十三件の投稿、三十七件中三十六件のメディア、そして三件の画像参照の欠落を正確に検出し、ツールは期待通り終了コード2で終了したのである。この結果は、wp-moveが単にファイルを移行するだけでなく、移行の「品質」を厳しくチェックし、問題があればそれを明確に通知する能力を持っていることを証明している。

現在のところ、wp-moveは主に公式のテーマテストデータを使用してテストされており、実際の運用されているWordPressサイトでの本格的な検証はまだこれからである。そのため、多様なプラグインやカスタマイズが施された実運用環境での動作保証は、今後の課題となる。また、生成される_redirectsファイルも、NetlifyやCloudflare Pagesといった具体的なホスティング環境での動作確認はまだ行われていない。さらに、WordPressサイトに寄せられたコメントの移行、カテゴリやタグの専用ページ、そしてサイトのデザインを司るテーマ自体の移行機能はまだ実装されていない。WordPressで多用されるショートコード（特定の機能やコンテンツを埋め込むための短い記述）については検出はされるものの、自動変換には対応していない。しかし、これらの制限は今後の開発によって改善されていく見込みである。開発者はWordPressサイトの所有者に対し、wp-moveを実際に試し、レポートに誤りや不足を見つけた場合は、プライベートな情報を除いてGitHubのIssue（課題報告）としてフィードバックを提供してくれるよう呼びかけている。このようなユーザーからのフィードバックは、ツールの精度と機能をさらに向上させるために非常に重要となる。wp-moveはMITライセンスで公開されており、GitHubでそのソースコードを確認できるほか、ツールの動作を示すデモ動画も提供されている。

このツールは、単なるエクスポート機能ではなく、移行の完全性を徹底的に検証することで、システムエンジニアやウェブサイト管理者が直面する多くの課題を解決しようとしている。サイト移行における不安や手作業でのチェックの負担を大幅に軽減し、「エクスポート完了」の先にある「完全な移行」という目標を達成するための強力な助けとなることを目指しているのである。