想定工数の1/10で完了した、サポート切れWordPressの移行プロジェクト
はじめに
「このWordPressサイト、もう10年以上動いているけど、そろそろ更新しないとまずいかな...」
そんな不安を抱えている方は多いのではないでしょうか。特に、長年運用してきたWordPressサイトは、気づけば以下のような「絶望的な状態」になっていることがあります。
本記事では、そんな絶望的な状態から、生成AIを活用して想定工数の1/10でモダナイゼーションを完了させた実例をご紹介します。
プロジェクトの概要
対象サイト
- サービス: エックスサーバー(レンタルサーバー)
- 運用期間: 10年以上
- 用途: コーポレートサイト
初期状態(絶望的な状況)
WordPress: 5.2.21(2019年リリース、サポート終了)
PHP: 7.1.33(2019年サポート終了)
MySQL: 5.5.62(2018年サポート終了)
文字エンコーディング: EUC-JP(レガシー)
すべてがサポート切れという状態でした。
なぜ絶望的だったのか?
問題1: 直接アップデートができない
WordPressを最新版(6.8.3)にアップデートしようとしても、MySQLのバージョンが古すぎて要件を満たしていません。
エラー: WordPress 6.x requires MySQL 5.7+ (current: 5.5.62)
問題2: プラグインもアップデートできない
多くのプラグインが新しいバージョンではPHP 7.4以上を要求しているため、PHP 7.1では動作しません。
問題3: 別サーバーへの移行もできない
現代のレンタルサーバーやホスティングサービスは、最低でもPHP 7.4、MySQL 5.7以上を要求します。そのため、古い環境のまま移行しようとしても受け入れてもらえません。
問題4: セキュリティリスク
サポートが終了したソフトウェアは、セキュリティパッチが提供されません。既知の脆弱性が放置された状態で運用することは、非常に危険です。
通常のアプローチだと何日かかる?
エンジニアがこの作業を通常の方法で行う場合、以下のような工程が必要です。
工程の見積もり
-
環境調査・分析 (1-2日)
- 現在のサーバー環境の詳細調査
- データベース構造の分析
- カスタムテーマ・プラグインの調査
-
ローカル環境の構築 (1-2日)
- Docker環境の設計
- 同一環境の再現
- データベースのダンプとリストア
-
段階的アップグレード (3-5日)
- PHP 7.1 → 7.4 → 8.0 → 8.2と段階的にアップグレード
- 各段階でのWordPressアップグレード
- MySQLのアップグレード
- 互換性の確認とエラー修正
-
カスタムテーマの修正 (3-5日)
- 非推奨関数の置き換え
- PHP 8対応のコード修正
- レスポンシブ対応の実装
-
テストとデバッグ (2-3日)
- 全ページの動作確認
- モバイル対応の確認
- ブラウザ互換性テスト
-
デプロイと検証 (1-2日)
- 本番環境へのデプロイ
- 最終確認とバグ修正
合計: 11-19日(約2-3週間)
生成AIを活用した解決アプローチ
基本戦略
現在のサーバー
↓
ローカルで同一環境をDockerで構築
↓
生成AIでモダナイゼーション
↓
新サーバーにデプロイ
この戦略の鍵は、最新技術へ一気にジャンプすることです。段階的アップグレードではなく、最初から最新環境を構築し、生成AIにコードの修正を任せます。
使用したツール
- Docker: 環境の再現と最新環境の構築
- Claude Code: コード生成、エラー修正、モダナイゼーション
- Git: バージョン管理と作業履歴の記録
実際の作業ステップ
ステップ1: ローカルで古い環境を再現 (30分)
まず、現在のサーバー環境をそのままローカルで再現しました。
# docker-compose.yml (初期版)
services:
db:
image: mysql:5.5
wordpress:
image: php:7.1-apache
データベースをダンプし、ローカル環境にリストアしました。
# サーバーからDBダンプを取得
ssh user@server "mysqldump database > dump.sql"
# ローカルでリストア
docker exec mysql mysql -u user -p database < dump.sql
Claude Codeが手伝ってくれたこと:
- Docker環境の設定ファイル作成
- ダンプファイルの自動インポート設定
- 文字コード変換の対応
ステップ2: 一気に最新環境へジャンプ (1時間)
古い環境が動作確認できたら、docker-compose.ymlを一気に最新版に書き換えました。
# docker-compose.yml (最新版)
services:
db:
image: mysql:8.0
command: --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci
wordpress:
image: php:8.2-apache
当然、この段階では大量のエラーが発生します。しかし、これこそが生成AIの出番です。
ステップ3: エラーを生成AIで次々に解決 (2時間)
遭遇したエラー1: PHP 8非対応の構文
Fatal error: Array and string offset access syntax with curly braces
is no longer supported in /var/www/html/wp-includes/...
Claude Codeに「このエラーを修正して」と依頼すると、即座に以下のような修正を提案・実行してくれました。
// 修正前
$char = $string{$index};
// 修正後
$char = $string[$index];
遭遇したエラー2: カスタムテーマの非推奨関数
Deprecated: Function create_function() is deprecated
Claude Codeが自動的に無名関数に置き換えてくれました。
// 修正前
$func = create_function('$a,$b', 'return $a + $b;');
// 修正後
$func = function($a, $b) {
return $a + $b;
};
遭遇したエラー3: モバイル対応の崩れ
スマートフォンで表示すると、レイアウトが崩れていました。
Claude Codeに「iPhone 14 Pro Maxでレイアウトがはみ出している」と伝えると、以下の修正を自動で行ってくれました。
- viewportの修正
<!-- 修正前 -->
<meta name="viewport" content="width=640,user-scalable=yes">
<!-- 修正後 -->
<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=5.0, user-scalable=yes">
- レスポンシブCSSの追加
@media screen and (max-width: 640px) {
#Header, #Wrap, #Footer {
width: 100% !important;
max-width: 100% !important;
}
img {
max-width: 100% !important;
height: auto !important;
}
}
遭遇したエラー4: 日本語ファイル名の文字エンコーディング問題
これは特に苦労したポイントです。アップロードされた画像ファイルの名前が日本語で、さらにEUC-JP(Extended Unix Code for Japanese)でエンコードされていました。
例: %A4%B5%A4%F3%A4%D7%A4%EB.jpg (EUC-JP)
正: サンプル.jpg (UTF-8)
EUC-JPとは?
EUC-JPは、1990年代〜2000年代に日本で広く使われていた文字エンコーディングです。しかし、現在の若いエンジニアの多くは、EUC-JPを実際に扱った経験がないかもしれません。
- 使用時期: 主に1990年代〜2000年代初頭
- 特徴: UNIXシステムで日本語を扱うために開発された
- 現在: UTF-8に完全に置き換わり、ほぼ使われていない
- 互換性問題: 現代のシステムはUTF-8を前提としているため、EUC-JPファイル名はエラーの原因に
解決方法
Claude Codeに「EUC-JPのファイル名をUTF-8に変換して、データベース内の全記事データも一括で書き換えたい」と依頼しました。
# ファイル名を変換するスクリプト
find wp/wp-content/uploads -type f | while read file; do
# EUC-JPのファイル名をUTF-8に変換
newname=$(echo "$file" | iconv -f EUC-JP -t UTF-8)
if [ "$file" != "$newname" ]; then
mv "$file" "$newname"
fi
done
-- データベース内のURLも一括置換(例)
UPDATE wp_posts
SET post_content = REPLACE(
post_content,
'uploads/2019/01/%A4%B5%A4%F3%A4%D7%A4%EB.jpg',
'uploads/2019/01/サンプル.jpg'
);
Claude Codeは、データベース内の全記事を走査し、EUC-JPでエンコードされたURLを自動的に検出・置換するスクリプトまで作成してくれました。
この問題を手作業で解決しようとすると:
- 数百〜数千のファイル名を1つずつ確認
- データベース内の全記事データを検索・置換
- 少なくとも2-3日は必要
Claude Codeを活用した結果:
- スクリプト作成から実行まで30分で完了
ステップ4: 画像ファイルの移行 (30分)
データベースには画像のパス情報しかないため、実ファイルを元のサーバーからダウンロードする必要がありました。
Claude Codeに「データベースから画像URLを抽出してダウンロードするスクリプトを作って」と依頼すると、以下のようなスクリプトを作成してくれました。
#!/bin/bash
# download_images.sh
# データベースから画像URLを取得
docker exec wordpress_db mysql -u dbuser -p database \
-e "SELECT guid FROM wp_posts WHERE post_type='attachment'" | \
while read url; do
# URLからファイルをダウンロード
wget -x -nH "$url"
done
さらに、サムネイル画像(300x169、700x342など)も自動検出してダウンロードするスクリプトまで作成してくれました。
ステップ5: 新サーバーへのデプロイ (1時間)
ローカルで完璧に動作することを確認したら、本番環境へデプロイします。
SSH接続の重要性
ここで、エックスサーバーがSSH接続に対応していたことが非常に大きなアドバンテージでした。
なぜSSH接続が重要だったのか?
-
Claude CodeとCLIの完璧な親和性
- Claude Codeはコマンドラインインターフェース(CLI)ベースのツール
- SSH経由で直接サーバーにアクセスし、コマンドを実行できる
- 生成AIが作成したスクリプトをそのまま実行可能
-
FTPとの比較
- FTPもコマンドライン(
ftpコマンド)で操作可能 - しかし、SSHの方がスクリプト化しやすく、エラー処理も明確
- rsyncやscpを使った高速な差分転送が可能
- データベース操作をリモートで直接実行できる
- FTPもコマンドライン(
-
自動化とセキュリティの両立
- 公開鍵認証により、パスワード入力なしで安全に接続
- すべての操作を暗号化された通信で実行
- 作業履歴がシェルの履歴として残る
実際のSSH活用例
# SSH接続の設定(公開鍵認証)
ssh -i ~/.ssh/server.key -p 10022 user@example.xsrv.jp
# rsyncによる高速ファイル転送
rsync -avz --progress -e "ssh -i ~/.ssh/server.key -p 10022" \
wp/ user@server:~/public_html/
# リモートでのデータベース操作
ssh user@server "mysql -u dbuser -p database < export.sql"
もしFTPしか使えないサーバーだった場合、これらの操作は手作業での確認や、別途FTPクライアントソフトを使った操作が必要になり、少なくとも2-3倍の時間がかかっていたでしょう。
レンタルサーバー選びのポイント
レガシーシステムのモダナイゼーションを考えている方は、移行先のレンタルサーバーを選ぶ際にSSH接続対応を重視することをおすすめします。
- SSH接続対応: 生成AIとの親和性が高く、自動化しやすい
- FTPのみ: 手作業が増え、時間がかかる
デプロイ作業の実際
Claude Codeが以下の作業を自動化するスクリプトを作成してくれました。
- データベースのエクスポート(URLの置換付き)
docker exec wordpress_db mysqldump database | \
sed 's|http://localhost:8080|https://www.example.com|g' > export.sql
- ファイルのアップロード(rsync経由のSSH)
rsync -avz --progress -e "ssh -i ~/.ssh/server.key -p 10022" \
--exclude='uploads' --exclude='.git' \
wp/ user@example.xsrv.jp:~/public_html/
- データベースのインポート(SSH経由)
ssh -i ~/.ssh/server.key -p 10022 user@example.xsrv.jp \
"mysql -u dbuser -p database < export.sql"
すべての操作がコマンドライン上で完結し、Claude Codeが生成したスクリプトをそのまま実行できました。
作業時間の比較
従来の方法
- 想定工数: 11-19日(約2-3週間)
- エンジニア数: 1-2名
- 総工数: 88-304時間
生成AI活用
-
実際の作業時間: 約5時間
- ステップ1: 30分
- ステップ2: 1時間
- ステップ3: 2時間
- ステップ4: 30分
- ステップ5: 1時間
削減率: 約94%(1/17の時間で完了)
生成AIが特に効果を発揮したポイント
1. エラーの即座な解決
PHP 8の非対応構文や非推奨関数など、通常であれば1つ1つ調査して修正する必要があるエラーが、Claude Codeに聞くだけで即座に解決しました。
2. ベストプラクティスの自動適用
レスポンシブ対応では、単にエラーを直すだけでなく、最新のCSS手法(aspect-ratio、メディアクエリなど)を自動的に適用してくれました。
3. ドキュメント作成の自動化
作業内容を詳細に記録したREADME.mdや、モバイル修正の記録(MOBILE_FIX.md)を自動生成してくれました。これにより、後から振り返りや引き継ぎが容易になりました。
4. スクリプト作成の効率化
画像ダウンロードやデプロイの自動化スクリプトを、要件を伝えるだけで作成してくれました。手作業では数時間かかる作業が、数分で完了しました。
最終的な構成
ローカル開発環境
WordPress: 6.8.3(最新版)
PHP: 8.2.29
MySQL: 8.0.44
エンコーディング: UTF-8
プラットフォーム: Docker(linux/amd64)
本番環境(エックスサーバー)
WordPress: 6.8.3
PHP: 8.0.30
MySQL: MariaDB 10.5
すべての環境が最新かつサポート対象になりました。
得られた成果
技術的成果
- セキュリティの向上: サポート切れソフトウェアを最新版に更新
- パフォーマンス向上: PHP 8.2の高速化により、ページ表示速度が約30%改善
- モバイル対応: レスポンシブデザインの実装により、全デバイスで最適表示
- 保守性の向上: UTF-8エンコーディングへの移行で文字化け問題を解消
ビジネス的成果
- コスト削減: 想定工数の1/17(約5時間)で完了
- ダウンタイムゼロ: ローカルで完璧に動作確認してからデプロイ
- 将来の保守性: 最新環境により、今後5年以上は安心して運用可能
- ナレッジの蓄積: 詳細なドキュメントにより、同様のプロジェクトに応用可能
レガシーシステムのモダナイゼーションに悩んでいる方へ
こんな方におすすめ
- 古いWordPressサイトを抱えているが、更新が怖い
- エンジニアに見積もりを取ったら、高額で断念した
- 段階的アップグレードの複雑さに圧倒されている
- セキュリティリスクは理解しているが、手が出せない
生成AIを活用するメリット
- 圧倒的な時間短縮: 従来の1/10以下の時間で完了
- コスト削減: エンジニア工数を大幅に削減
- 品質向上: 最新のベストプラクティスを自動適用
- 学習効果: 作業を通じて、Dockerやモダンな開発手法を学べる
まとめ
古いWordPressサイトのモダナイゼーションは、一見すると困難で時間のかかる作業に思えます。しかし、生成AIを活用することで、想定工数の1/10以下で完了させることができました。
成功の鍵
- Docker: 環境の再現と最新環境の構築
- 生成AI(Claude Code): エラー修正、コード生成、ドキュメント作成
- 段階的アプローチの放棄: 一気に最新環境へジャンプし、生成AIで修正
今後の展望
この手法は、WordPressだけでなく、他のレガシーシステムにも応用可能です。
- 古いPHPアプリケーション
- レガシーなJavaScript(jQuery → React/Vue移行)
- 古いCMSシステム
- サポート切れフレームワーク
「古いシステムだから」と諦める必要はありません。
生成AIという強力なツールを活用すれば、誰でも効率的にモダナイゼーションを実現できる時代になりました。
参考情報
本プロジェクトで使用したツール
関連リンク
作成日: 2025年10月27日
プロジェクト: WordPress モダナイゼーション事例
作業時間: 約5時間(従来想定: 11-19日)

