更新しなくなったWordPressを、静的サイトとして残す
2026-10-23 wordpress ruby
Claude Codeに手伝ってもらって作りました。
WordPressで管理していた古いブログがあります。2019年から更新は止まっていたのですが、WordPressは動かし続けていました。更新しないサイトでも、WordPress本体やPHP、プラグインの更新はやめられません。かといって消してしまうと、よそから貼ってもらったリンクも切れてしまいます。
そこで、WordPressのDBとアップロード済みの画像から、同じ見た目のHTMLを作り直すツール（wordpress-archiver）を作って、PHPもMySQLも使わない静的なサイトに置き換えました。上の画像が切り替え後のトップページです。見た目はもとのまま、中身はただのHTMLと画像です。
2つのやり方
更新しなくなったWordPressを静的に残す方法は、大きく2つあると思います。
- 公開中のサイトを巡回して保存する（
wget --mirrorや、WordPressの静的化プラグインなど） - DBの中身からHTMLを組み立て直す
最初は1.の方法で試しました。手軽ですが、CSSに付く?ver=…や、/?p=123のような短縮URL、/wp-json/などのWordPressらしいURLを一つずつ手当てする必要があります。DBに直接さわれるなら、2.のほうが確実です。巡回で取りこぼす心配がなく、何をどのURLに出すかを自分で決められます。
wordpress-archiverでやっていること
Rubyの標準ライブラリだけで書いていて、DBはmysqlコマンドで読みます。WordPress本体は一切動かしません。
- 本文の整形（段落の
<p>化、引用符の変換、ブロックエディタの記事の描画、「続きを読む」など）は、WordPressのthe_contentと同じ順番で同じ処理をするように、PHPのソースから移植しました - テーマ（Twenty Fifteen）のHTMLを再現して、CSS・JS・フォントはテーマのファイルをそのまま使います
- 出力するのは、投稿・固定ページ・トップ／カテゴリ／投稿者の一覧（ページ送り付き）・RSS・404ページです
- 他の記事に埋め込まれたときのカード（
/…/embed/）も作るので、ブログ内で記事を貼っていた部分もそのまま表示されます /?p=123や/?page_id=45の短縮URLは、.htaccessで元のURLへリダイレクトします- 検索・コメント・ログインなど、動的な部分は出しません
本当に同じになっているか
いちばん気を使ったのは「同じ見た目」です。次の3段階で確かめました。
- 整形の処理は、WordPress本体の
formatting.phpをPHPで動かした結果と、全297件の本文・タイトルで完全に一致 - 公開中のサイトの全388ページと、本文・サイドバー・タイトル・ヘッダー・フッターのHTMLを比べて一致
- ブラウザで主なページを表示して、各要素の高さがピクセル単位で一致
もとのサイトで切れていた画像（旧ステージング環境の証明書切れ）が、逆に表示されるようになったのはおまけです。
手順
- サーバから
wp-content/uploadsとテーマ、wp-includesの静的なファイルを手元にコピーする - 設定ファイルにDBの読み方（例:
ssh サーバ mysql DB名）と出力先を書いて、ruby wordpress_archiver.rb 設定.ymlを実行する - 手元で表示を確認してから、できた
htdocs/をサーバに置き、VirtualHostのDocumentRootを切り替える
このブログの場合、ビルドは数秒、HTMLは687ファイル、画像を含めて670MBほどでした。切り替え前のWordPressはディレクトリもDBも残してあるので、DocumentRootを戻せばいつでも元に戻せます。
ついでに、左のサイドバーの「Recent Posts」を「About」（ブログの説明と、伊藤製作所への案内）に置き換え、フッターにこのブログについてへのリンクを足しました。DBには手を入れず、ツールの設定ファイルで差し替えています。
おすすめしたいこと
もう更新しないWordPressサイトがあって、DBとファイルにアクセスできるなら、消してしまう前に静的化を検討してみてください。
- 書いたものとURLがそのまま残る（よそからのリンクも切れない）
- PHPもDBも公開しないので、更新作業もセキュリティの心配もほぼなくなる
- 置き場所はHTMLが置けるところならどこでもよい
今回は自分のブログ（Twenty Fifteen）に合わせて作ったので、ほかのテーマではテンプレートを書き足す必要があります。似たようなサイトを抱えている方がいたら、お気軽にご用命ください（仕事依頼受付）。