サーバーの管理画面でPHPのバージョンを切り替えた直後、サイトが真っ白になった。あるいはトップページは出るのに、記事の編集画面だけが読み込まれない。この種の連絡は、レンタルサーバー各社が古いPHPのサポート終了を告知する時期に固まって来ます。原因の型はほとんど決まっていて、切り分けの順番も決まっています。ここでは止まったサイトをまず動く状態に戻す手順と、そのあと何と何を突き合わせれば原因のプラグインが名指しできるのかを書きます。停止して見えるようになった状態は復旧ではなく応急処置なので、戻し方と直し方は分けて考えます。
最短の一手は、切り戻しです
調査より先にPHPのバージョンを元に戻します。切替が管理画面の選択式になっているサーバーなら、戻す操作も数十秒で終わります。表示が回復すれば、その時点で「PHPのバージョンが原因である」ことも確定します。原因究明を先にやろうとして、止まったサイトを何時間も放置するほうがはるかに損です。
ただし、戻せない場合が二つあります。ひとつは、サーバー会社が旧バージョンの提供そのものを終了していて、選択肢にもう出てこないケース。もうひとつが、同じサーバーに複数のサイトが同居しているケースです。PHPのバージョンは多くの環境でサーバー単位、あるいはドメイン単位で適用されます。1サイトを助けるために戻した設定が、同居している別サイトを巻き込んで壊すことがあります。作業前に、そのサーバーで何サイト動いているかを必ず確認してください。
戻せたなら、そこからは落ち着いて調べられます。戻せないなら、次の切り分けをその場でやることになります。
症状の出方で、止まっている層はかなり絞れます
全ページが真っ白なら、PHPが処理を途中で中断しています。テーマかプラグインのどちらかで致命的なエラー、いわゆる Fatal error が出ている状態です。フロントだけが落ちて管理画面には入れるなら、テーマ側かフロント側でのみ読み込まれるプラグインが怪しい。逆に管理画面だけが開かないなら、管理画面でのみ動く機能を持つプラグインを疑います。特定の1ページ、特定の1機能だけが動かないなら、犯人は最初から1本に絞られています。
ここで一度は疑ってほしいのが、そもそもサイトが壊れていない可能性です。「PHPのエラーが出ている」という相談を受けて調べたところ、実際にはローカルのエディタが古いPHPバージョン向けの設定のままで、新しい書き方の構文を文法エラーとして赤く表示していただけ、という案件がありました。サイト自体は正常に動いていました。画面に赤い表示が出ている、という報告を受けたときは、それがブラウザで開いた実サイトなのか、手元のエディタの表示なのかを最初に確認します。ここを飛ばすと、動いているものを何時間も調べることになります。
サーバー側の要因が絡んでいそうなときは、サイトが表示されないときにまず確認するサーバー側の4か所のほうから当たると早いこともあります。
ログに出るのは、管理画面に表示されている名前ではありません
エラーログを開くと、落ちたファイルのパスと行番号が出ます。ここで多くの人がつまずくのが、パスに含まれるプラグインのディレクトリ名が、管理画面のプラグイン一覧に並んでいる表示名と一致しないことです。
実際にあった例では、ログに js_composer というディレクトリ名が出ていました。これは管理画面上では「WPBakery Visual Composer」という名前で表示されているページビルダーです。名前が違うので「そんなプラグインは入れていない」となり、調査が止まります。ログに出るのは常に内部のディレクトリ名だと覚えておけば、ここで迷いません。分からなければFTPで wp-content/plugins/ の中を見て、該当ディレクトリの中にある本体ファイルの先頭を開けば、そこに表示名が書いてあります。
もうひとつ。相談してくださる方から「たぶん◯◯というプラグインが原因です」と申告があっても、その名前のプラグインが管理画面に存在しないことがあります。申告を出発点にするのは構いませんが、鵜呑みにせず自分でプラグイン一覧を確認してください。
突き合わせるのは3つだけ
PHPを上げた直後の障害は、次の3つを並べればほぼ特定できます。1つずつ探すのではなく、3つを同時に見るのが要点です。
| 見るもの | どこで見るか | 何が分かるか |
|---|---|---|
| エラーログ | サーバーの管理画面、または logs 相当のディレクトリ | 落ちたファイルのパスと行番号。犯人のディレクトリ名がここに出る |
| PHPのバージョン | サーバーの管理画面、または phpinfo() の出力 | いつ、どのバージョンからどこへ上がったか |
| プラグインの最終更新日 | 管理画面のプラグイン一覧、配布ページ | 新しいPHPに追随しているか。数年止まっていれば要注意 |
最終更新が数年前で止まっているプラグインは、新しいPHPで削除された関数や書き方をそのまま使っている確率が高くなります。ログに出たディレクトリ名と、更新が止まっているプラグインの一覧が重なったら、そこが原因です。
PHPの設定はバージョンだけではありません。メモリの上限に当たって落ちている場合は、症状が似ていても対処が変わります。判断がつかないときはWordPressのメモリ不足エラーを解消するPHP設定の直し方も合わせて見てください。アップロード周りの上限で止まるMP4動画がアップロードできない・再生されないときの確認点のような症状も、根はPHPの設定値です。
実際にあった全落ちと、その日のうちにやったこと
小規模事業者のコーポレートサイトで、サイト全体が表示されなくなったという相談を受けました。状況としてはPHPのバージョンを変更した直後で、白画面と500エラーが混在していました。
調べると、ログに出ていたのは先ほどの js_composer、つまりページビルダー系のプラグインでした。さらに、バックアップ系のプラグインが同時に読み込まれる構成になっていて、この組み合わせでフックが競合し、処理が途中で止まっていました。ページビルダーはテーマの表示処理に深く入り込むタイプで、バックアップ系は管理画面と定期処理の両方に入り込みます。どちらもPHPの仕様変更の影響を受けやすい位置にいます。
やったことは、該当するプラグインを停止して表示を回復させることでした。作業自体はその日のうちに終わっています。ただし、これは応急処置です。停止したプラグインが担っていたレイアウト機能は止まったままですし、PHPのバージョンとプラグインの組み合わせという根本の不整合は残っています。同じサイトで、次のバージョン更新のときに再発する可能性がある状態でした。
止まった時点で復旧を優先するのは正しい判断です。問題は、表示が戻った瞬間に案件が終わったことになりがちな点です。停止したプラグインをどうするかは、別の作業として必ず残してください。
停止したままにしないための、順番が決まった作業
PHPのバージョン更新を事故なく通すには、順番が決まっています。壊れてから直すより、この順番で先にやったほうが安く済みます。
- 現状のPHPバージョンと、WordPressコア・テーマ・プラグインのバージョンを一覧で控える
- データベースとファイルのバックアップを取る
- プラグインとテーマを先に最新化してから、コアを更新する
- サーバーの管理画面でPHPのバージョンを上げる
- フロントと管理画面の主要ページを巡回し、警告と Fatal error が出ていないか確認する
- デバッグログで非推奨の警告を確認し、必要なら該当プラグインを差し替える
3番の順序は、実務でいちばん効きます。コアを先に上げてからプラグインを追いかけると、その途中で互換性のエラーが出やすくなります。プラグイン、テーマ、コア、最後にPHP。この順です。
それと、作業の記録を残してください。「PHPを7.4から8.1へ、WordPressコアを◯.◯から◯.◯へ、更新したプラグインはこれとこれ」。この3行があるかどうかで、次に不具合が出たときの調査時間が変わります。記録がないと、次に触る人は前提の確認からやり直すことになります。これは他人に頼むときだけでなく、自分でやる場合も同じです。継続的にこの記録を残す運用は保守プランの中でやっていることの一つでもあります。
よくある質問
原因のプラグインを止めたら、デザインが崩れました
ページビルダー系を止めた場合は、ほぼ確実に崩れます。ビルダーが持っているショートコードや独自の記法が、そのまま文字として本文に出てしまうためです。この状態で運用を続けるのは現実的ではないので、選択肢は三つになります。プラグインを新しいPHPに対応したバージョンへ更新する、開発が止まっているなら同等の機能を持つものへ移す、あるいはビルダーで作られたページを通常のHTMLとして作り直す。どれを選ぶかは、そのビルダーで作られたページが何枚あるかで決まります。数枚なら作り直しが早く、数十枚あるなら更新か乗り換えを検討することになります。
サーバー会社から古いPHPのサポート終了を知らせるメールが来ました。何から手をつけますか
期限までに時間があるなら、いきなり切り替えないでください。まずWordPressコア、テーマ、プラグインをすべて最新にして、そのうえでPHPを上げます。更新が止まっているプラグインが一覧に混じっていたら、そこが事故の起点になります。切替のタイミングは、アクセスが少なく、直後に画面を確認できる時間帯を選んでください。切り替えた直後に誰も見ていない、が一番まずい形です。
テスト環境がありません。本番でぶっつけで上げるしかないですか
そのまま上げること自体は可能ですが、条件があります。切り戻せる状態を先に作ることです。データベースとファイルのバックアップを取り、PHPのバージョンを戻す操作の手順を確認しておく。この二つが揃っていれば、壊れても数分で元に戻せます。逆に、バックアップがない状態での切替はおすすめしません。レンタルサーバー内にテスト用のサブドメインを立てて複製する方法もあり、規模によってはそちらのほうが結局は早く終わります。
更新の直後ではなく、しばらく経ってから壊れました。関係ありますか
関係していることがあります。PHPを上げた時点では表示できていても、そのあと初めて使った機能でエラーになる場合があるためです。問い合わせフォームの送信、予約の登録、CSVの出力といった、毎日は動かない処理が該当します。PHPを上げたあとは、トップページだけでなく、フォーム送信や検索など動きのある機能をひと通り触って確認してください。止まったまま気づかず数週間、という事故はこの経路で起きます。緊急で止まっている場合の対応は障害復旧の対応内容にまとめています。