0
2

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

More than 1 year has passed since last update.

生成AIで実現する超効率的なレガシーWordPressのモダナイゼーション

0
Posted at

想定工数の1/10で完了した、サポート切れWordPressの移行プロジェクト

a_古いWordpresをモダナイゼーション.png

はじめに

「この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. 環境調査・分析 (1-2日)

    • 現在のサーバー環境の詳細調査
    • データベース構造の分析
    • カスタムテーマ・プラグインの調査
  2. ローカル環境の構築 (1-2日)

    • Docker環境の設計
    • 同一環境の再現
    • データベースのダンプとリストア
  3. 段階的アップグレード (3-5日)

    • PHP 7.1 → 7.4 → 8.0 → 8.2と段階的にアップグレード
    • 各段階でのWordPressアップグレード
    • MySQLのアップグレード
    • 互換性の確認とエラー修正
  4. カスタムテーマの修正 (3-5日)

    • 非推奨関数の置き換え
    • PHP 8対応のコード修正
    • レスポンシブ対応の実装
  5. テストとデバッグ (2-3日)

    • 全ページの動作確認
    • モバイル対応の確認
    • ブラウザ互換性テスト
  6. デプロイと検証 (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でレイアウトがはみ出している」と伝えると、以下の修正を自動で行ってくれました。

  1. 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">
  1. レスポンシブ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接続が重要だったのか?

  1. Claude CodeとCLIの完璧な親和性

    • Claude Codeはコマンドラインインターフェース(CLI)ベースのツール
    • SSH経由で直接サーバーにアクセスし、コマンドを実行できる
    • 生成AIが作成したスクリプトをそのまま実行可能
  2. FTPとの比較

    • FTPもコマンドライン(ftpコマンド)で操作可能
    • しかし、SSHの方がスクリプト化しやすく、エラー処理も明確
    • rsyncやscpを使った高速な差分転送が可能
    • データベース操作をリモートで直接実行できる
  3. 自動化とセキュリティの両立

    • 公開鍵認証により、パスワード入力なしで安全に接続
    • すべての操作を暗号化された通信で実行
    • 作業履歴がシェルの履歴として残る

実際の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が以下の作業を自動化するスクリプトを作成してくれました。

  1. データベースのエクスポート(URLの置換付き)
docker exec wordpress_db mysqldump database | \
  sed 's|http://localhost:8080|https://www.example.com|g' > export.sql
  1. ファイルのアップロード(rsync経由のSSH)
rsync -avz --progress -e "ssh -i ~/.ssh/server.key -p 10022" \
  --exclude='uploads' --exclude='.git' \
  wp/ user@example.xsrv.jp:~/public_html/
  1. データベースのインポート(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

すべての環境が最新かつサポート対象になりました。

得られた成果

技術的成果

  1. セキュリティの向上: サポート切れソフトウェアを最新版に更新
  2. パフォーマンス向上: PHP 8.2の高速化により、ページ表示速度が約30%改善
  3. モバイル対応: レスポンシブデザインの実装により、全デバイスで最適表示
  4. 保守性の向上: UTF-8エンコーディングへの移行で文字化け問題を解消

ビジネス的成果

  1. コスト削減: 想定工数の1/17(約5時間)で完了
  2. ダウンタイムゼロ: ローカルで完璧に動作確認してからデプロイ
  3. 将来の保守性: 最新環境により、今後5年以上は安心して運用可能
  4. ナレッジの蓄積: 詳細なドキュメントにより、同様のプロジェクトに応用可能

レガシーシステムのモダナイゼーションに悩んでいる方へ

こんな方におすすめ

  • 古いWordPressサイトを抱えているが、更新が怖い
  • エンジニアに見積もりを取ったら、高額で断念した
  • 段階的アップグレードの複雑さに圧倒されている
  • セキュリティリスクは理解しているが、手が出せない

生成AIを活用するメリット

  1. 圧倒的な時間短縮: 従来の1/10以下の時間で完了
  2. コスト削減: エンジニア工数を大幅に削減
  3. 品質向上: 最新のベストプラクティスを自動適用
  4. 学習効果: 作業を通じて、Dockerやモダンな開発手法を学べる

まとめ

古いWordPressサイトのモダナイゼーションは、一見すると困難で時間のかかる作業に思えます。しかし、生成AIを活用することで、想定工数の1/10以下で完了させることができました。

成功の鍵

  1. Docker: 環境の再現と最新環境の構築
  2. 生成AI(Claude Code): エラー修正、コード生成、ドキュメント作成
  3. 段階的アプローチの放棄: 一気に最新環境へジャンプし、生成AIで修正

今後の展望

この手法は、WordPressだけでなく、他のレガシーシステムにも応用可能です。

  • 古いPHPアプリケーション
  • レガシーなJavaScript(jQuery → React/Vue移行)
  • 古いCMSシステム
  • サポート切れフレームワーク

「古いシステムだから」と諦める必要はありません。

生成AIという強力なツールを活用すれば、誰でも効率的にモダナイゼーションを実現できる時代になりました。

参考情報

本プロジェクトで使用したツール

  • Claude Code: コード生成、エラー修正
  • Docker: 環境構築
  • Git: バージョン管理
  • エックスサーバー: レンタルサーバーa_古いWordpresをモダナイゼーション.png

関連リンク


作成日: 2025年10月27日
プロジェクト: WordPress モダナイゼーション事例
作業時間: 約5時間(従来想定: 11-19日)

0
2
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
2

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?