ある案件で5年以上前に作られたWordpressサイトを最新版にバージョンアップすることになったので、その際の手順を紹介します。

サーバーのバージョンアップで古いサイトが表示されなくなる

要件・依頼内容

クライアント様から「契約しているサーバー会社から『PHP5.4からPHP8.1にアップデートする』との連絡があった。WEBサイトが見られなくなるかもしれないので対応して欲しい。」とのお問い合せを頂きました。

調査結果

クライアントのサイトはWordpress4.2系で作られており、PHP8.1では動作しないことが判明。

WordPressを最新の6.0へバージョンアップする必要が発生しました。

問題点

WP管理画面からWP6.0へアップデートしようとしても、PHPが古すぎて実行できない。そして、先にサーバーのPHPを8.1へバージョンアップしてしまうと、WPが動作せず管理画面に入れなくなるという問題があり、ワンクリックで簡単アップデートはできそうにない。

解決方法

管理画面からはアップデートできないので、Wordpress公式サイトから最新版をダウンロードしてFTPでファイルをアップロードし、その後PHPを切替える方法を選択。

具体的な手順

テスト

テスト環境構築
まずは現行と全く同じ環境でテストサイトを構築するため、現行サイトと同じバージョンのWPをWordpress公式からダウンロードしインストール。その後、「All in one WP migration」プラグインで現行サイトからデータインポートするのが手っ取り早くて楽です。
PHP8.1で確認
テストサーバーのPHPを8.1にバージョン切り替えてみる。今回の件ではWPの管理画面すら入れなくなり、動作しないことが判明。
テーマファイル確認
テスト環境のWPを最新（6.0）にアップデートして動作確認。管理画面には入れるようになったが、テーマファイルにエラーやWarningが出たので、一つずつ修正して潰していく。

本番環境バージョンアップ下準備編

PHPバージョン切換えをスムーズに実施するための下準備をしておきます。

バックアップ作成
ここも「All in one WP migration」プラグインでバックアップ取るのが簡単でオススメです。
最新版のWordpressをFTPでアップロード
現行版は/wp/ディレクトリにインストールされていたので、別ディレクトリ/wp6/を作ってその中にアップロード。
プラグイン「All in one WP migration」をアップロード
/wp6/wp-config/plugins/ に「All in one WP migration」プラグインをアップロード。場合によってはサーバー側のアップロードサイズを変更できないことがあるので拡張プラグイン「Unlimited Extension（無制限版）」も同時にアップロードしておく。
wp-configをコピー
現行の/wp/wp-config.php を/ver6/ へコピーする。

本番バージョンアップ実施編

メンテナンスページに切換え
WP maintenanceとかプラグインを使いたかったが、WPのバージョンが古すぎて動作せず。仕方がないので仮のindex.htmlをアップして「メンテナンス中」を表示。
PHPバージョン切換え
サーバーコントロールパネルから手動でPHPバージョンを5.4から8.1へ変更。
ディレクトリ差替え
旧 /wp/ディレクトリを別名（wp-oldとか）に変更し、wp6ディレクトリをwpにリネーム。
データ復元
管理画面へログインし、プラグイン「All in one WP migration」及び「unlimited extension」をアップデートした後、All in one WP migration からバックアップデータを復元（インポート）する。
データベースを更新
インポート後、「データベースを更新しますか」と聞かれるので「はい」を選んで更新。
テーマファイル更新
テストで修正したテーマファイルをアップロードします。
プラグインをすべてアップデート
古いプラグインを最新版にアップデートする。一部最新のWordpressに対応できていないプラグインもあるので削除するか代用品をインストールする。ちなみの今回はContact Form7の送信データを保存する「Contact Form DB」が動作しなかったので、代わりにFlamingoをインストールしておきました。
お問合せフォームを修正
Contact form7 の動作検証を行うとエラーが出ていたので修正し、フォーム送信確認を行う。
”year”など一部のタグ名が使えなくなっていたり、メールアドレスを必須項目にしなくてはならない、など仕様が変更になっている。
Classic Editor プラグインをインストール
クライアントは新しいブロックエディタに使い慣れていないので、従来のClassic Editorをインストール。「投稿設定」からデフォルトエディターを「旧エディター」に指定。
パーマリンク設定を更新
不要かもしれないけど、念のためパーマリンク設定を更新しておく（変更はせず、更新ボタンを押すだけ）。
テスト投稿
記事を投稿してきちんと更新できているか確認。同時に画像やアイキャッチ、カテゴリーの指定も確認する。確認したらテスト投稿は削除。
公開
一通りページをチェックしたら、メンテナンスページを削除してサイトを公開する。
旧バージョンを削除
/wp-old/ディレクトリは必要なければ削除する。残す場合はパーミッションを400にするなどしてアクセス制限掛けておく。