はじめに
WordPressのアップグレードは、セキュリティの改善や機能追加など、サイトを最新かつ最適な状態に保つために重要です。しかし、時には予期しないエラーが起こり、アップグレードが失敗してしまうことがあります。この記事では、アップグレード失敗時の復旧方法を紹介し、トラブルシュートのステップや注意点について詳しく説明します。
症状・背景
- アップグレード後の「白い画面」（White Screen of Death: WSOD）が表示される
- サイトにアクセスできない、またはアクセスできるが機能不全である
- WordPressのコントロールパネルにログインできず、404エラーなどが発生する
- アップグレード途中でサーバーがタイムアウトし、完全に完了しなかった
手順・設定方法
ステップ1: PHPとデータベースのエラー確認
# WordPressのログファイルを確認します。
tail -n 50 /var/www/html/wp-content/debug.log
# データベースに接続して、wp_optionsテーブルのsiteurlとhomeフィールドを確認します。
mysql -u root -p wordpressdb
USE wordpress;
SELECT option_value FROM wp_options WHERE option_name = 'siteurl' OR option_name = 'home';ステップ2: WordPressファイルを削除し、新しいバージョンをインストール
# WordPressのディレクトリに移動します。
cd /var/www/html/
# 既存のWordPressファイルとフォルダを削除します（pluginsフォルダやuploadsフォルダなどは残す）。
rm -rf wp-admin wp-includes wp-content/plugins/* wp-content/themes/*
# WordPress.orgから最新バージョンをダウンロードします。
wget https://wordpress.org/latest.tar.gz
# ダウンロードしたファイルを解凍します。
tar -xvzf latest.tar.gz
mv wordpress/* .
rm -rf latest.tar.gz wordpressステップ3: wp-config.phpと.htaccessの確認・修正
# wp-config.phpを編集し、データベース接続情報が正しく記述されていることを確認します。
nano /var/www/html/wp-config.php
# .htaccessファイルを開き、WordPress用に適切な設定を行います。
nano .htaccessステップ4: キャッシュとプラグインの無効化によるトラブルシューティング
# ファイルシステム上のキャッシュを削除します。
rm -rf /var/www/html/wp-content/cache/*
# PHPのオペレーティングモードでwp-admin/install.phpを実行して、データベースとWordPressの接続を確認します。
php wp-admin/upgrade.php注意事項
- <実践的な注意点1>: ファイルやディレクトリを削除する前に必ずバックアップを取ること。
- <実践的な注意点2>: サーバーのPHPバージョンが古い場合、最新版との互換性問題が発生する可能性があるため確認すること。
- <セキュリティ上の注意>: wp-config.phpファイルにパスワードやシークレットキーを適切に記述し、公開しないようにすること。
- <パフォーマンス/運用上の注意>: サイトの利用状況によっては一時的にアクセスが停止する可能性があるため、ユーザーへの事前通知を行うこと。
まとめ
1. エラー確認: 上記手順で示したコマンドを使用してPHPやデータベース関連のエラーを確認します。
2. ファイル更新: WordPressファイルとフォルダを削除し、最新版をインストールすることでアップグレード失敗後の復旧を行います。
3. 設定ファイル修正: wp-config.phpと.htaccessファイルを適切に編集してWordPressの正常動作を確保します。
4. キャッシュ無効化: キャッシュやプラグインを一時的に無効にして、問題が発生している部分を特定します。
5. 再試行: 以上の手順で問題が解決しない場合、再度アップグレードを試みるか、WordPressのサポートコミュニティに相談することをお勧めします。
関連記事: