PHPでエラー表示を有効・変更する設定方法：開発と運用の使い分けを解説

PHPを用いたウェブアプリケーション開発において、エラー表示の設定は開発効率とセキュリティの両面に直結する極めて重要な要素です。

プログラムが意図した通りに動作しないとき、適切なエラーメッセージが表示されることで、エンジニアは迅速に原因を特定し修正を行うことが可能になります。

一方で、本番環境でエラー情報をそのまま表示してしまうと、サーバーの内部構造やパス情報が第三者に漏洩し、重大なセキュリティリスクを招く恐れがあります。

2026年現在のモダンなPHP開発シーンにおいても、これらの設定を環境ごとに適切に使い分けることは、プロフェッショナルなエンジニアにとって必須のスキルと言えるでしょう。

本記事では、PHPのエラー表示を有効化・変更するための具体的な設定方法から、開発環境と運用環境でのベストプラクティスまでを詳しく解説します。

PHPにおけるエラー表示の基本概念

PHPのエラー表示は、主に「どのレベルのエラーを報告するか」と「報告されたエラーを画面に出力するか」という2つの軸で制御されます。

PHPには軽微な注意勧告から致命的な実行停止まで、さまざまなエラーレベルが存在します。

これらの設定は、サーバー全体の挙動を決める設定ファイルや、個別のスクリプト内から動的に変更することが可能です。

主なエラーの種類とレベル

PHPで発生するエラーは、その深刻度に応じていくつかの種類に分類されています。

開発を進める上で特によく遭遇するエラーの種類を以下の表にまとめました。

これらのエラーレベルを適切にキャッチすることが、堅牢なコードを書くための第一歩となります。

特にE_NOTICEやE_DEPRECATEDを無視せずに修正することで、将来的な不具合を未然に防ぐことができます。

エラー表示を設定する3つの方法

PHPの設定を変更するには、主に3つのアプローチがあります。

使用しているサーバー環境や、権限の有無によって最適な方法を選択してください。

1. php.iniファイルを編集する

サーバー全体の基本設定を変更する場合、php.iniファイルを編集するのが最も一般的です。

このファイルはPHPの動作を規定するマスター設定ファイルであり、ここで設定した内容はすべてのPHPスクリプトに適用されます。

設定を変更した後は、変更を反映させるためにWebサーバー（ApacheやNginxなど）の再起動が必要になる点に注意してください。

2. .htaccessファイルを使用する（Apache環境）

Apacheサーバーを利用している場合、ディレクトリ単位で設定を上書きできる.htaccessファイルを利用できます。

php.iniを直接編集する権限がない共有レンタルサーバーなどでよく用いられる手法です。

設定を記述する際は、php_flagやphp_valueというプレフィックスを使用します。

3. PHPスクリプト内でini_set関数を使用する

特定のプログラム内だけで一時的にエラー表示を切り替えたい場合は、ini_set()関数を使用します。

実行時に動的に設定を変更できるため、デバッグ作業を行う際などに非常に便利です。

ただし、構文エラー（E_PARSE）はスクリプトが実行される前に発生するため、この方法では表示できないことに留意してください。

開発環境での推奨設定：すべてのエラーを可視化する

開発環境では、バグを早期に発見するために、可能な限りすべてのエラーを表示させる設定が推奨されます。

以下の設定を適用することで、タイポや非推奨の関数利用などを即座に把握できるようになります。

php.iniでの設定例

php.iniを編集する場合は、以下の項目を検索して値を書き換えてください。

; すべてのエラーを報告する
error_reporting = E_ALL

; 画面にエラー内容を表示する
display_errors = On

; スクリプト起動時のエラーも表示する
display_startup_errors = On

PHPスクリプト内での設定例

コードの冒頭に記述して、エラー表示を有効にする例です。

<?php
// すべてのエラーレベルを対象にする
error_reporting(E_ALL);

// エラー表示を有効にする
ini_set('display_errors', '1');

// 未定義の変数を参照してエラーを発生させるテスト
echo $undefined_variable;
?>

上記のコードを実行すると、次のような結果が表示されます。

Warning: Undefined variable $undefined_variable in /path/to/script.php on line 8

このように、エラーが発生したファイルパスと行番号が明示されるため、デバッグがスムーズに進みます。

本番（運用）環境での推奨設定：情報を隠匿しログに記録する

本番環境では、ユーザーに対してエラーの詳細を見せるべきではありません。

エラー画面からサーバーのディレクトリ構造やDBの接続情報が漏れることは、重大な脆弱性につながります。

本番環境ではエラーを非表示にしつつ、管理者だけが後から確認できるようにファイルへ記録する設定を行います。

セキュリティを重視したphp.iniの設定

本番環境ではdisplay_errorsを必ずOffに設定してください。

; エラーを画面に表示させない
display_errors = Off

; スクリプト起動時のエラーも非表示にする
display_startup_errors = Off

; エラーをログファイルに記録する
log_errors = On

; ログファイルの出力先パス（環境に合わせて調整が必要）
error_log = /var/log/php_errors.log

この設定により、ブラウザ上には何も表示されなくなりますが、サーバー内の指定したパスにエラー内容が蓄積されます。

これにより、ユーザー体験を損なうことなく、開発者は後から問題の追跡が可能になります。

主要なエラー設定ディレクティブの解説

PHPの設定項目（ディレクティブ）には、エラー制御に関するものがいくつか存在します。

それぞれの役割を正しく理解することで、より細かな制御が可能になります。

error_reporting

どのレベルのエラーを収集・報告するかを定義します。

E_ALLはすべてのエラーを指しますが、特定のレベルを除外することも可能です。

例えば、E_ALL & ~E_NOTICEと記述すると、「通知以外すべて」を報告対象にします。

display_errors

エラーをブラウザ（標準出力）に出力するかどうかを制御します。

開発効率を優先する場合はOn、セキュリティを優先する場合はOffにするのが鉄則です。

この値がstderrに設定されている場合、出力は画面ではなく標準エラー出力（サーバーログなど）へ送られます。

log_errors

エラーメッセージをサーバーのログ、あるいはerror_logで指定した先に保存するかどうかを決定します。

本番環境ではdisplay_errorsをOffにする代わりに、必ずこれをOnにする必要があります。

エラーが発生していることに気づけないという事態を防ぐための生命線となります。

error_log

エラーを記録するファイルのフルパスを指定します。

指定しない場合、Webサーバーのエラーログ（Apacheのerror.logなど）に統合されて出力されることが一般的です。

アプリケーション固有のログファイルを作成することで、他のシステムログと分離して管理しやすくなります。

エラーが表示されない場合のチェックリスト

設定を変更したはずなのにエラーが表示されない場合、いくつかの原因が考えられます。

問題解決のために、以下のポイントを順番に確認してください。

1. 設定ファイルの反映を確認する

php.iniを変更した場合、サーバーの再起動が完了しているか確認してください。

また、編集しているphp.iniが本当に現在使用されているものか、phpinfo()関数で確認することも重要です。

<?php
phpinfo();
?>

出力された情報の「Loaded Configuration File」の項目に記載されているパスが、正しい設定ファイルです。

2. 構文エラーの存在

前述の通り、プログラム自体に構文エラーがある場合、スクリプト内のini_set()は読み込まれません。

この場合、画面が真っ白になる「ホワイトスクリーン」現象が発生します。

この状況を打破するには、サーバー本体の設定ファイル（php.iniや.htaccess）で表示を有効にするしかありません。

3. 上位の設定による上書き

フレームワーク（LaravelやSymfonyなど）を使用している場合、フレームワーク独自のハンドラがエラーを制御していることがあります。

その場合、PHP本体の設定よりもフレームワークの設定（.envファイルなど）が優先されます。

環境変数APP_DEBUGなどの設定値が適切かどうかをチェックしてください。

実務で役立つエラーログの活用術

エラーログはただ記録するだけでなく、効果的に活用することで運用の質を高められます。

現代の開発現場で推奨されるログ管理の考え方を紹介します。

ログのローテーション設定

エラーログを放置すると、ファイルサイズが肥大化しディスク容量を圧迫します。

OSのlogrotate機能などを利用して、古いログを自動で圧縮・削除する仕組みを整えましょう。

これにより、常に最新の状況を軽量なファイルで確認できるようになります。

エラー通知の自動化

致命的なエラーが発生した際に、ログに記録するだけでなくチャットツール（SlackやTeams）へ通知する仕組みを導入するのも有効です。

PHPのライブラリである「Monolog」などを使用すれば、エラーレベルに応じて通知先を柔軟に変更できます。

これにより、障害発生から検知までのタイムラグを最小限に抑えることが可能になります。

PHP 8.x以降におけるエラー処理の傾向

近年のPHPバージョンアップに伴い、以前は「Warning」だったものが「Error（例外）」として扱われるケースが増えています。

これにより、プログラムが停止しやすくなった反面、予期せぬ動作を未然に防げるようになりました。

2026年現在の開発においても、厳格な型指定と合わせてエラー設定を適切に管理することが、高品質なソフトウェア開発のスタンダードとなっています。

過去の古いコード（レガシーコード）を最新環境に移行する際は、特にE_DEPRECATEDを有効にして、修正すべき箇所を洗い出すことから始めると良いでしょう。

まとめ

PHPにおけるエラー表示設定は、開発の快適さとシステムの安全性を天秤にかける重要なスイッチです。

開発環境ではすべてのエラーを表示してバグの芽を摘み取り、本番環境では一切の情報を隠してログに託すという使い分けを徹底してください。

php.ini、.htaccess、そしてini_setという3つの手段を適切に選べるようになることで、どんなインフラ環境でも柔軟に対応できるようになります。

適切なエラー管理こそが、ユーザーにとって信頼性の高いサービスを提供するための基盤となります。

今回解説した設定方法を参考に、自身の開発環境を見直してみてはいかがでしょうか。