PHP更新後の互換性エラーを調査するエンジニア

古いPHPを更新するときに発生しやすいエラー

古いPHPから新しいPHPへ更新した際に起こりやすいエラーと、ログ・依存関係・拡張機能・定期処理を確認する方法を解説します。

古いPHPを新しいバージョンへ更新すると、これまで動いていたホームページやWebシステムで突然エラーが発生することがあります。

原因はPHP本体だけとは限りません。古いプログラムの記述、フレームワークやライブラリ、PHP拡張、サーバー設定、データベース、定期処理など、複数の要素が関係します。

この記事では、PHP更新時に起こりやすい症状と、調査するポイントを整理します。

画面が真っ白になる・500エラーになる

PHPの致命的なエラーで処理が停止すると、画面が真っ白になったり、「500 Internal Server Error」が表示されたりします。

この場合、最初に確認するのはエラーログです。表示された症状だけでは、テーマ、プラグイン、独自コード、設定のどこで止まったか判断できません。

  • PHPのエラーログ
  • Apache・NginxなどのWebサーバーログ
  • WordPressのデバッグログ
  • フレームワークのアプリケーションログ

本番画面に詳細なエラーを表示すると内部情報が見えるため、ログへ記録して確認します。

TypeError・ArgumentCountErrorが発生する

新しいPHPでは、関数へ渡す値の型や引数の数が以前より厳密に確認される場合があります。以前は警告だけで処理が続いていたコードが、TypeErrorなどで停止することがあります。

エラーメッセージに表示されるファイル名と行番号を確認し、呼び出し側と関数定義の両方を調べます。一時的にエラーを抑制するだけでなく、想定する値と処理を整理して修正する必要があります。

非推奨の警告が大量に表示される

新しいPHPでは、将来削除される機能や推奨されない書き方に対して非推奨警告が追加されます。すぐ停止しない警告でも、次回以降の更新でエラーになる可能性があります。

PHP公式の移行ガイドで、後方互換性のない変更と非推奨機能を確認します。複数バージョンをまたぐ場合は、途中の各移行ガイドも順に確認します。

「未定義の関数」と表示される

新サーバーや新しいPHP環境に、必要な拡張モジュールが入っていない場合に発生します。

  • 画像処理で利用するGD・Imagick
  • 国際化処理で利用するIntl
  • 暗号化やHTTPS通信で利用するOpenSSL・cURL
  • ZIPファイルを扱うZip
  • データベース接続に必要な拡張

旧環境と新環境の有効な拡張一覧を比較し、アプリケーションが必要とするものを明確にします。

Composerの依存関係を解決できない

フレームワークや外部ライブラリをComposerで管理している場合、パッケージ側が新しいPHPへ対応していない、または古いロックファイルが更新を妨げることがあります。

本番で安易にComposer updateを実行すると、多数のライブラリが同時に変わる可能性があります。開発・検証環境で依存関係を確認し、変更内容を固定してから本番へ反映します。

データベース接続や文字化けが発生する

PHP拡張、データベースの認証方式、SQLモード、文字コード、照合順序などの違いで、接続エラーや文字化けが起こる場合があります。

接続できるかだけでなく、登録、更新、検索、並び順、絵文字、CSV入出力まで確認します。SQLの警告やエラーもログで確認します。

ログイン状態やセッションが維持されない

セッションの保存先、Cookie設定、HTTPS化、キャッシュ、複数台構成などの違いにより、ログインがすぐ切れることがあります。

管理画面と利用者画面の両方で、ログイン、ログアウト、権限、一定時間経過後の動作を確認します。

Cronやバッチ処理だけ失敗する

ブラウザーから実行されるPHPと、コマンドラインで実行されるPHPが別バージョンになっていることがあります。そのため、画面は正常でも、夜間処理、メール送信、集計、バックアップだけが失敗するケースがあります。

  • Cronが呼び出すPHPの実行パス
  • コマンドライン側のPHPバージョン
  • 環境変数と作業ディレクトリ
  • 実行ユーザーとファイル権限
  • 実行結果とエラーログの保存先

メール・ファイルアップロード・外部APIが動かない

タイムアウト、SSL証明書、暗号方式、ファイルサイズ上限、テンポラリディレクトリ、送信元設定など、周辺設定の違いも確認します。

お問い合わせフォームは、画面上の完了表示だけでなく、管理者への通知と利用者への自動返信が届くことまでテストします。

エラーを減らす進め方

  1. 旧環境のPHP・拡張・設定・依存ライブラリを記録する
  2. PHP公式の移行ガイドを確認する
  3. 静的解析や互換性チェックで候補を洗い出す
  4. 検証環境でPHPを更新する
  5. 自動テストと重要機能の手動テストを行う
  6. 警告を含めてログを確認し、原因を修正する
  7. バックアップと切り戻し手順を準備して本番反映する

有限会社リッチアンドワイズでは、古いPHPシステムの調査、互換性改修、検証環境の準備、本番切替まで対応しています。

Linux・PHP・WordPress バージョンアップ支援の詳細を見る

参考情報

本記事は2026年11月20日時点の公式情報をもとに作成しています。