PHPのログファイルを活用したエラートラッキング完全ガイド｜初心者でもわかるPHPデバッグ入門

PHP のログファイルを活用したエラートラッキング

先生と生徒の会話形式で理解しよう

生徒

「PHPでプログラムを書いたんですけど、画面が真っ白になって原因がわからないです…」

先生

「それはエラーが裏で起きている可能性がありますね。そんなときに役立つのがログファイルです。」

生徒

「ログファイルって何ですか？パソコン初心者でも使えますか？」

先生

「大丈夫です。ログファイルは“プログラムの日記”みたいなものなので、順番に見ていきましょう。」

1. PHPのログファイルとは？

PHPのログファイルとは、プログラムの中で起きた出来事やエラー内容を文字として保存しておくファイルのことです。人間で例えると、体調が悪くなったときにお医者さんが診断メモを書くようなものです。PHPは、エラーが発生した理由や場所をログとして残すことで、後から原因を調べやすくしてくれます。画面に何も表示されなくても、ログファイルを見れば問題点が書かれていることが多く、エラートラッキングの基本になります。

2. エラートラッキングとは何をすること？

エラートラッキングとは、プログラムで発生したエラーを追跡して、原因を特定し、修正するまでの一連の作業のことです。初心者のうちは「動かない＝失敗」と感じがちですが、実際はエラーが起きるのが普通です。ログファイルを使えば、「いつ」「どこで」「どんなエラーが起きたのか」が記録されるため、暗闇の中を手探りするような作業から解放されます。

3. PHPでエラーログを出力する基本設定

まずはPHPでエラーログを出力できるように設定します。設定とは、PHPに「エラーが起きたら記録してね」とお願いすることです。難しそうに見えますが、数行で設定できます。


ini_set('log_errors', 'On');
ini_set('error_log', __DIR__ . '/error.log');

この設定により、同じフォルダ内にerror.logというログファイルが作られます。ログは自動で追記されるため、ノートにメモを書き足していく感覚で使えます。

4. わざとエラーを出してログを確認してみよう

実際にエラーを発生させて、ログファイルに何が書かれるか確認してみましょう。体験することで理解が深まります。


echo $test;

上記のコードでは、存在しない変数を使っています。この状態で実行すると、画面には何も出ないことがありますが、ログファイルにはエラー内容が記録されます。


Notice: Undefined variable: test

5. error_log関数で自分のメモを書く

PHPにはerror_log関数という便利な機能があります。これはエラーだけでなく、自分で指定した文章をログに書き込める仕組みです。「ここまで処理が来た」という目印として使えます。


error_log('処理がここまで実行されました');

これにより、プログラムの流れをログで追いかけることができます。迷子にならないための道しるべのような役割です。

6. ログファイルを見るときのポイント

ログファイルを見るときは、上から順番に読む必要はありません。基本は一番下を確認します。最新のエラーが一番下に追加されるためです。また、エラーの種類（Notice、Warning、Fatal error）を見ることで、深刻さも判断できます。Fatal errorは「プログラムが止まった」という意味なので、最優先で対応します。