PHP の set_error_handler を完全解説！初心者でもわかる独自エラーハンドリングの作り方

1. PHP の set_error_handler() とは？

1. PHP の set_error_handler() とは？

PHPの set_error_handler() は、「エラーが発生したときに呼び出される関数を、自分で指定できる仕組み」です。これを使うと、通常であればブラウザに直接表示されるエラー内容を、あなたの好きな処理で受け取り、ログに保存したり、メール通知したり、画面にはやさしいメッセージを表示することができます。

たとえば、通常ならPHPはエラーが発生すると画面に内容を表示します。しかし本番環境ではエラー内容がユーザーに見えてしまうと危険です。サーバーのファイル名や内部構造が漏れてしまう可能性があるためです。そこで set_error_handler() を使えば、画面には「問題が発生しました」とだけ表示し、内部ではエラーログに記録することができます。

2. 独自エラーハンドラーの基本構造

2. 独自エラーハンドラーの基本構造

独自のエラーハンドリングを作るには、「自分で関数を作り、それを set_error_handler() に登録する」という流れになります。イメージとしては「エラーをキャッチする専用の窓口を自分で作る」ような感じです。

function myErrorHandler($errno, $errstr, $errfile, $errline) {
    error_log("[Error $errno] $errstr ($errfile:$errline)");
    echo "エラーが発生しました。しばらくしてから再度お試しください。";
}

set_error_handler("myErrorHandler");

上記の例では、エラーが発生すると myErrorHandler() が呼ばれます。そしてエラー内容をログに保存して、画面にはユーザー向けメッセージを表示します。

この仕組みを知ることで、エラー対応が一気にレベルアップします。本番環境でエラーが出てもユーザーは気づかず、裏側だけでログを確認できるようになるため、セキュリティ面にも強くなります。

3. set_error_handler のパラメータの意味

3. set_error_handler のパラメータの意味

set_error_handler() に登録する関数は、基本的に次の4つのパラメータを受け取ります。

• $errno：エラーの種類（Warning など）
• $errstr：エラーの内容（メッセージ）
• $errfile：エラーが起きたファイル名
• $errline：エラーが起きた行番号

これらの情報を使えば、エラーの原因を特定しやすくなり、ログとして保存する際にもとても役に立ちます。

4. カスタムハンドラーでエラーをログに記録する

4. カスタムハンドラーでエラーをログに記録する

実際にエラー内容をログファイルに記録しつつ、画面には出さない例を紹介します。

function logOnlyHandler($errno, $errstr, $errfile, $errline) {
    $log = date("Y-m-d H:i:s") . " [$errno] $errstr ($errfile:$errline)";
    error_log($log, 3, __DIR__ . "/error.log");
}

set_error_handler("logOnlyHandler");

// わざとエラーを発生
echo $undefined;

このコードで実行される流れは次の通りです。

1. 未定義変数 $undefined を使いエラー発生
2. logOnlyHandler が呼ばれる
3. エラー内容が error.log に保存される
4. 画面には何も表示されない

こうすることで、ユーザーには一切エラー情報を見せず、管理側だけがログを確認できる仕組みが作れます。

5. set_error_handler を使うときの注意点

5. set_error_handler を使うときの注意点

非常に便利な set_error_handler() ですが、いくつか注意点があります。

● 注意1：Fatal Error には対応できない

set_error_handler() は Notice や Warning を処理できますが、Fatal Error（致命的エラー）は処理できません。これはPHPが実行を続けられない種類のエラーだからです。

● 注意2：エラーを無視しないようにする

ログを記録せずに何も表示しない設計にすると、不具合に気づけなくなります。必ずログには記録するようにしましょう。

● 注意3：本番環境と開発環境で使い分ける

開発環境ではエラーを画面に表示、本番では非表示でログに保存、など使い分けが必要です。環境ごとに設定できるようにしておくと便利です。

6. 実務でよく使われるエラーハンドリングの構成例

6. 実務でよく使われるエラーハンドリングの構成例

最後に、実務でよく使われる構成例を紹介します。

function errorHandler($errno, $errstr, $errfile, $errline) {

    $log = "[" . date("Y-m-d H:i:s") . "] ($errno) $errstr in $errfile on line $errline\n";
    error_log($log, 3, __DIR__ . "/runtime_error.log");

    if ($errno === E_USER_ERROR) {
        echo "重大な問題が発生しました。";
    }
}

set_error_handler("errorHandler");

この方法だと、エラーの種類を判断しながら処理を変えたり、重要なエラーだけ通知することができるようになります。PHPアプリケーションの安全性と品質を大きく向上させるための、大切なテクニックです。

まとめ

まとめ

set_error_handler の理解を深めるポイント

本記事では、PHPにおけるエラーハンドリングの中でも特に重要な set_error_handler() の仕組みについて詳しく解説してきました。エラー処理は単なるデバッグのための機能ではなく、システムの品質やセキュリティを大きく左右する重要な要素です。特にWebアプリケーション開発においては、ユーザーに不要な情報を見せない設計が求められるため、独自のエラーハンドリングは必須のスキルと言えるでしょう。

set_error_handler() を使うことで、PHPが標準で出力するエラーメッセージをそのまま表示するのではなく、自分で制御できるようになります。これにより、開発環境では詳細なエラー情報を表示し、本番環境ではユーザーに優しいメッセージだけを表示しつつ、内部ではログに記録するという柔軟な設計が可能になります。

エラーハンドリングとログ管理の重要性

エラーハンドリングを適切に行うことで、バグの早期発見やシステム障害の原因特定が容易になります。特に error_log() と組み合わせて使用することで、発生したエラーをファイルに記録し、後から分析できるようになります。これは大規模なシステム開発だけでなく、小規模なプロジェクトでも非常に役立つ実践的なテクニックです。

また、エラー内容にはファイルパスや内部構造などの機密情報が含まれることが多いため、これをそのままユーザーに表示するのは危険です。独自エラーハンドラーを実装することで、セキュリティ対策としても非常に有効になります。

実務で活かせる設計の考え方

実務では、単にエラーを処理するだけでなく、エラーの種類ごとに対応を変えることが重要です。例えば、軽微な警告（Warning）はログに残すだけにし、重大なエラー（Fatalに近いもの）は管理者へ通知するなど、状況に応じた処理設計が求められます。

また、開発環境と本番環境で挙動を切り替える設計も重要です。環境変数や設定ファイルを使って、エラー表示の有無やログ出力先を変更できるようにしておくと、より柔軟で安全なシステムになります。

サンプルプログラムで振り返る

function customErrorHandler($errno, $errstr, $errfile, $errline) {

    // ログ用メッセージ生成
    $message = "[" . date("Y-m-d H:i:s") . "] ";
    $message .= "Error:$errno ";
    $message .= "$errstr in $errfile on line $errline\n";

    // ログファイルへ出力
    error_log($message, 3, __DIR__ . "/app_error.log");

    // ユーザー表示制御
    if ($errno === E_USER_ERROR) {
        echo "重大なエラーが発生しました。管理者へ連絡してください。";
    } else {
        echo "現在システムで問題が発生しています。";
    }
}

// ハンドラー登録
set_error_handler("customErrorHandler");

// テスト用エラー
echo $testUndefined;

上記のように、エラーハンドラーを一元管理することで、コード全体の保守性が向上します。複数のファイルで個別にエラー処理を書く必要がなくなり、修正や改善も一箇所で対応できるようになります。