PHPでログを残そうと思ったのに、いつまで経ってもエラーが記録されない。そんな状況に陥ると、原因を探るのが難しく感じます。この記事では、「PHP エラーログ 出力されない 原因」という観点から、設定ミス・環境の問題・コード上の事情などさまざまな角度から原因を掘り下げ、設定の確認手順までわかりやすく解説します。PHPのログ出力でお困りの方に向けた最新情報です。
PHP エラーログ 出力されない 原因となるPHP設定ミス
まずはPHPの基本設定を見直すことが出発点です。設定ファイル(php.iniやPHP-FPMプール設定など)に誤りがあると、エラーが画面にもログにも出力されなくなってしまいます。ここでは代表的な設定ミスのパターンを挙げ、説明します。
log_errorsがOffになっている
PHPでエラーをログに出力するためには、設定項目「log_errors」をOnにする必要があります。Offのままだと、画面に表示されるかどうかはともかく、エラーログファイルに何も書き込まれません。開発環境でも本番環境でも、ログ収集には必須の設定です。
error_reportingのレベルが低い
error_reportingで許可するエラーのレベルが限定的だと、Notice・Warning・Deprecatedなど軽度のエラーが除外されてしまいます。すべての種類のエラーを拾いたいなら、error_reporting = E_ALL を設定するのが推奨されています。PHPのバーションによってE_ALLの意味が変わるので、最新版の説明を確認することが大切です。
display_errorsとdisplay_startup_errorsの設定不一致
display_errorsは画面にエラーを表示するかどうかを制御する設定で、本番環境ではOffにするのが安全です。対してdisplay_startup_errorsはPHPが初期化段階で起こすエラーに影響します。スクリプト実行前のエラーはこの設定でしか表示されないため、parseエラーや設定ファイル読み込み時の問題などが見えない原因になります。
ファイルパス・ディレクトリ・パーミッションに関する原因
設定が正しくても、書き込む先のファイルパスが間違っていたり、パーミッションが不足していたりするとログは出力されません。ここではファイル・ディレクトリ周りのトラブルを中心に解説します。
error_logで指定したパスが存在しないあるいは誤っている
error_logディレクティブで指定されたファイルパスが存在しないとログは作成されません。相対パスを使っていると、ドキュメントルートや現在の作業ディレクトリからの相対として解釈され、意図とずれることがあります。絶対パスで指定するか、設定のひな形を確認しておくことが重要です。
ファイルまたはディレクトリの書き込み権限不足
ログファイル自体あるいはその親ディレクトリに対してPHPプロセスが書き込み権限を持っていないと出力できません。所有者・グループ・パーミッションを確認し、必要なら調整する必要があります。Linuxではchmodやchownを用いて、Webサーバーユーザーが書き込める設定にすることが一般的です。
error_logがsyslogや標準エラーログに出力されている
error_log設定に明示的なファイルを指定していない場合、または設定をsyslogに設定した場合、エラーはサーバーの一般的なエラーログに記録されることがあります。どのログに出ているか把握するためには、phpinfo()でerror_logの設定や、Webサーバーのerror_logディレクティブを確認することが必要です。
PHP-FPMやウェブサーバー構成が原因の可能性
PHPが単体で動作しているわけではなく、PHP-FPMやWebサーバー(Apache、Nginxなど)との連携やその構成によって、ログの出力先や優先順位が上書きされることがあります。設定ファイルの階層を理解し、どのレベルでどの設定が効いているかを確認しましょう。
php-fpmプール設定によるerror_logの上書き
PHP-FPMのプール設定(pool.confなど)では、php_admin_value[error_log]でログファイルが指定されており、この設定はini_setなどのランタイム設定では上書きできない場合があります。つまり、php-fpmの設定に別のログ先が指定されていると、php.iniの設定が無視されることがあります。
ウェブサーバー設定のphp_admin_value/php_flagによる制約
ApacheやNginxの設定で、php_admin_valueやphp_admin_flagを使ってerror_logやlog_errorsの設定が強制されている場合があります。サブディレクトリや仮想ホストごとの設定でこれらが設定されていると、php.iniの値が適用されないことがあるため、サーバー全体の設定を確認することが重要です。
PHPの起動方式(CLI vs CGI vs FPM)による差異
PHPを実行するモードによって読み込まれる設定ファイルの場所や優先順位が異なります。CLIモードで動かしているスクリプトと、ウェブサーバー経由で動かしているスクリプトではphp.iniの別のファイルを参照していたり、環境変数で設定が異なっていたりします。phpinfo()を使って実際に読み込まれているphp.iniを確認しましょう。
コードや実行時の事情が原因になるケース
設定や環境が整っていても、PHPコードや実行の仕方によりログ出力がブロックされてしまうことがあります。ここではコード側で起こりうる状況を見ていきます。
致命的エラー(parse errorなど)は実行前に発生する
構文エラーやPHPの起動前に生じる致命的なエラーは、スクリプトが読み込まれる前に発生するため、ini_setなどのランタイム設定ではキャッチできません。こうしたエラーを出力させるには、display_startup_errorsをOnにするか、サーバーのエラーログを確認する必要があります。
@演算子によるエラー抑制
コード内で@演算子を使ってエラーを抑制すると、その式で発生するWarningやNoticeなどはログに出なかったり、画面表示もされなかったりします。抑制演算子を使っていないか、あるいはその部分だけの問題かを確認することが大切です。
巨大なログメッセージや制限による切り捨て
log_errors_max_lenという設定により、ログに記録できるエラーメッセージの最大長が制限されることがあります。設定が小さい値になっていると、長いエラーメッセージが途中で切れてしまったり、まったく出力されなかったりする場合があります。PHPのバージョンによってこの設定が廃止されていたり意味が変わっていたりするため、最新の手引き資料で確認しましょう。
確認手順と設定見直しのステップバイステップ
上記の原因を踏まえて、実際にエラーログが出力されない原因を特定し解決するためのチェックリストを段階的に実行していきましょう。手順を追うことで確実に問題箇所を絞れます。
- phpinfoを出力してlog_errors・error_log・error_reporting・display_errors・display_startup_errorsの値を確認する
- php.ini編集後はウェブサーバーまたはPHP-FPMの再起動を行う
- error_logで指定したパスが絶対パスであり、存在していることを確認する
- ログファイルとその親ディレクトリに書き込み権限があることを確認する(WebサーバーやPHP-FPMが動かしているユーザーで)
- PHP-FPMやvirtual host設定でphp_admin_value・php_admin_flagで設定が強制されていないか確認する
- display_startup_errorsをOnにして、構文エラーや初期化エラーが見えるか確認する
- @演算子が使用されていないか、またはその影響を受ける可能性のある処理をチェックする
- エラーを意図的に発生させるテストコードを使って、ログが書き込まれるかどうか確認する
実例比較で原因と対策を把握する
実際のケースでどんな原因があり、どのような対策が有効か比較してみましょう。似たような問題を抱えた複数の事例を対比します。
| 原因例 | 症状 | 対策内容 |
|---|---|---|
| log_errorsがOff、またはphp.iniが読み込まれていない | ログに何も出ない。phpinfoでlog_errors=Off | php.ini内でlog_errorsをOnにし、正しいphp.iniを編集・再起動する |
| error_logのパスが存在しない、または書き込み不可 | ログファイルが生成されない、またはパーミッションエラーが発生 | 絶対パスを指定、ディレクトリとファイルの所有者と権限を正す |
| PHP-FPMプールで上書き設定されている | ini_setやphp.iniでの設定が反映されず、別のログファイルに記録される | プール設定でのphp_admin_value[error_log]やlog_errors設定を確認・修正 |
| 構文エラーなど起動前の致命的エラー | スクリプトがまったく実行されず白画面になる | display_startup_errorsをOnにし、サーバーのエラーログを確認する |
おすすめの安全な設定(開発環境・本番環境両対応)
ログが確実に取得できる設定と、それぞれの環境で安心して使えるオプションを紹介します。最新情報を踏まえて、PHPのバージョンや運用方針に応じて使い分けてください。
- error_reporting を E_ALL に設定し、可能なら未来を見据えて追加されるエラータイプ全てを拾える設定にする
- log_errors を常に On にする。ログ記録は必ず確保する。
- display_errors は開発では On、本番では Off に。display_startup_errors は開発時に On にして、問題特定後は Off にしておく
- error_log は絶対パスで指定し、ログ保存先のディレクトリが存在し、書き込み可能であることを確認する
- PHP-FPMやWebサーバーのプール設定で error_log や log_errors を強制されていないか確認し、必要ならそちらも整備する
- 長いエラーメッセージが切り捨てられないよう log_errors_max_len の設定をチェック。ただし一部のPHPバージョンでこの設定が廃止または無効化されているため、バージョンに応じた対処が必要
まとめ
「PHP エラーログ 出力されない 原因」は多岐にわたりますが、大きく分けるとPHPの設定ミス、ファイル/ディレクトリのパーミッション問題、PHP-FPMやウェブサーバーによる設定オーバーライド、コード側の事情という四つの領域に分類できます。まずは phpinfo を使って現在の設定を確認し、その後ログファイルのパスと権限を確かめ、サーバー構成で上書きされている設定がないかをチェックすることが最も効果的です。これらを順番に見直すことで、多くのケースでエラーログがしっかりと出力されるようになります。
コメント