登録日： 2025-02-08   最終更新日： 2025-03-21

Laravel ErrorExceptionについて

Laravel の ErrorException は、通常、PHP のネイティブエラー（例えば Warning や Notice）が Laravel のエラーハンドラによって Exception に変換されたときに発生します。 これは Laravel がエラーをキャッチし、例外 (Exception) として扱うための仕組みです。

ErrorException が発生する主な原因

未定義の変数・配列キーの使用

echo $undefinedVariable; // Notice: Undefined variable

$arr = [];
echo $arr['key']; // Warning: Undefined array key

ファイルの読み書きエラー

file_get_contents('non_existent_file.txt'); // Warning: file_get_contents(): Failed to open stream

ゼロ除算

echo 10 / 0; // Warning: Division by zero

関数の誤った使用

count(null); // Warning: count(): Parameter must be an array or Countable

メモリ不足

大量のデータ処理を行ったときに発生することがあります。

Laravel におけるエラーハンドリング

Laravel では app/Exceptions/Handler.php にエラーハンドリングの処理が定義されています。ErrorException をキャッチしてカスタム処理をしたい場合は、report メソッドや render メソッドを編集できます。

ErrorException をカスタムハンドリング

use Illuminate\Foundation\Exceptions\Handler as ExceptionHandler;
use Throwable;
use ErrorException;

class Handler extends ExceptionHandler
{
    public function report(Throwable $exception)
    {
        if ($exception instanceof ErrorException) {
            \Log::error('ErrorException 発生: ' . $exception->getMessage());
        }

        parent::report($exception);
    }

    public function render($request, Throwable $exception)
    {
        if ($exception instanceof ErrorException) {
            return response()->json(['error' => 'サーバー内部エラーが発生しました'], 500);
        }

        return parent::render($request, $exception);
    }
}

エラーのデバッグ方法

• storage/logs/laravel.log を確認

  • Laravel のエラーログは storage/logs/laravel.log に保存されます。
  • tail -f storage/logs/laravel.log でリアルタイムにログを監視できます。

• APP_DEBUG=true にして詳細エラーを表示

  • .env に APP_DEBUG=true を設定し、エラーの詳細を表示。

• try-catch でエラーをキャッチ

try {
    $value = file_get_contents('non_existent_file.txt');
} catch (\ErrorException $e) {
    echo "エラー: " . $e->getMessage();
}

まとめ

• ErrorException は Laravel が PHP のエラーを例外として扱う際に発生する。
• よくある原因は未定義変数、ゼロ除算、ファイルアクセスエラーなど。
• storage/logs/laravel.log や .env の APP_DEBUG=true を使ってデバッグ可能。
• Handler.php でカスタムエラーハンドリングも可能。

---