包简介

This is my package laravel-log-notifier

README 文档

README

Real-time Laravel error monitoring with Toast Notifications

Laravel Log Notifier is a developer-friendly Laravel package that captures application exceptions and sends real-time in-app toast notifications instantly.

It helps you stay informed about errors as they happen, without constantly checking logs or using expensive third-party services like Sentry or Bugsnag.

Key Features

Real-time Exception Capture - Instantly detects and captures exceptions
Toast Notifications - In-app alerts appear immediately in top-right corner
Global Display - Works across your entire application, no permissions needed
Interactive Modal - Click notifications to view full error details
Smart Pause - Hover over notifications to pause auto-close timer
Sound Alerts - Optional beep for critical errors
Professional UI - Styled like Laravel's native error page
Error Details - Shows message, file, line number, and full stack trace
Lightweight - No database required, uses simple JSON storage
Secure - Built with Laravel auth in mind
Zero Setup - Works out of the box, no complex configuration
Production Ready - Efficient and reliable error handling

Installation

Install via Composer:

composer require irabbi360/laravel-log-notifier

Publish the config file:

php artisan vendor:publish --tag="log-notifier-config"

Configuration

Configure your settings in config/log-notifier.php:

return [
    'enabled' => env('LOG_NOTIFIER_ENABLED', true),
    
    'levels' => ['error', 'critical', 'alert', 'emergency'],
    
    'notification' => [
        'title' => 'Laravel Error 🚨',
        'icon' => '/vendor/log-notifier/icon.png',
        'sound' => true, // Play sound on critical errors
    ],
];

Quick Start

Step 1: Register Exception Handler

In your bootstrap/app.php, add the Log Notifier exception handler:

<?php

use Illuminate\Foundation\Application;
use Illuminate\Foundation\Configuration\Exceptions;
use Illuminate\Foundation\Configuration\Middleware;
use Irabbi360\LaravelLogNotifier\LogNotifierWatcher;

return Application::configure(basePath: dirname(__DIR__))
    ->withConfiguration()
    ->withRouting()
    ->withMiddleware(function (Middleware $middleware) {
        // ... your middleware
    })
    ->withExceptions(function (Exceptions $exceptions) {
        // Register Log Notifier exception handler
        LogNotifierWatcher::handles($exceptions);
    })
    ->create();

Step 2: Add Notification Component

Add the notification component to your main layout (e.g., resources/views/layouts/app.blade.php):

<!DOCTYPE html>
<html>
<head>
    <!-- your head content -->
</head>
<body>
    <!-- your content -->

    <!-- Add Log Notifier notification component -->
    {!! LogNotifier::notification() !!}
</body>
</html>

Step 3: Enable in Environment

Make sure the package is enabled (default is true):

LOG_NOTIFIER_ENABLED=true

Done! All exceptions will now trigger real-time toast notifications. 🎉

📖 Usage

Automatic Error Capture

The package automatically captures all exceptions in your Laravel application. No manual setup required:

// Any unhandled exception will trigger a toast notification
throw new Exception('Something failed!');

// Database errors
DB::connection()->getPdo();

// Model validation errors
User::findOrFail($invalidId);

// Any other exception in your app...

Enable/Disable Notifications

Control the package via configuration:

// config/log-notifier.php
'enabled' => env('LOG_NOTIFIER_ENABLED', true),

Or via environment variable:

LOG_NOTIFIER_ENABLED=true   # Enable notifications
LOG_NOTIFIER_ENABLED=false  # Disable notifications

Filter Error Levels

Control which error levels trigger notifications:

// config/log-notifier.php
'levels' => [
    'emergency',  // System is unusable
    'alert',      // Action must be taken immediately
    'critical',   // Critical condition
    'error',      // Error condition
    // 'warning', 'notice', 'info', 'debug' - not monitored by default
],

Display Notifications in Your App

Add this single line to your main layout file (e.g., resources/views/layouts/app.blade.php):

{!! LogNotifier::notification() !!}

That's it! Errors will now show as toast notifications across your entire application.

Toast Notifications

Toast notifications appear automatically when exceptions occur in your application:

Features

Real-time - Instant notification delivery via Server-Sent Events (SSE)
Always Visible - Fixed position in top-right corner
Color-Coded - Visual indication by error level (red for error, orange for warning, etc.)
Hover to Pause - Auto-close timer pauses when hovering over the notification
Click for Details - Open modal with full error information
Sound Alerts - Optional beep for critical/alert level errors
Professional Styling - Matches Laravel's native error page design

User Interactions

Hover → Pause the auto-close countdown timer
Move Away → Resume the countdown
Click Toast → Open modal with detailed error information
Click Close Button (×) → Dismiss notification immediately
Press ESC Key → Close the error details modal
Click Outside Modal → Close the error details modal

How It Works

The package uses Server-Sent Events (SSE) for real-time error delivery:

Application Exception
        ↓
ExceptionTracker (JSON storage)
        ↓
SSE Stream (/api/stream)
        ↓
Browser EventSource Listener
        ↓
Deduplication Check
        ↓
Toast Notification Display
        ↓
User Interaction (Hover/Click)

Real-Time Delivery

Exceptions are captured instantly and streamed to the browser via SSE
No polling or page reloads required
Browser maintains persistent connection for instant notifications
Automatic reconnection if connection drops

Security

Built with Laravel Auth - Works with your existing auth system
No External Services - Everything runs on your server
No Sensitive Data Logging - Exceptions are not persisted beyond current session

Testing

composer test

Troubleshooting

Toast Notifications Not Appearing?

Check 1: Verify package is enabled

LOG_NOTIFIER_ENABLED=true

Check 2: Ensure notification view is included in layout

{!! LogNotifier::notification() !!}

Check 3: Check browser console for errors Open DevTools (F12) and look for JavaScript errors.

Check 4: Verify error levels match configuration

// config/log-notifier.php
'levels' => ['emergency', 'alert', 'critical', 'error'],

No Sound on Critical Errors?

Make sure sound is enabled in config:

'notification' => [
    'sound' => true,
],

Note: Browsers may require user interaction before playing audio.

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

License

The MIT License (MIT). Please see License File for more information.

irabbi360/laravel-log-notifier 适用场景与选型建议

irabbi360/laravel-log-notifier 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 21 次下载、GitHub Stars 达 0，最近一次更新时间为 2026 年 01 月 30 日，在 PHP 生态内属于活跃度较高的组件。

它主要适用于以下技术方向：「laravel」「Fazle Rabbi」「laravel-log-notifier」等业务场景。在实际项目中，围绕这些方向常见需要落地的问题包括：接口对接、性能调优、并发安全、与既有框架（Laravel / ThinkPHP / Yii / Webman 等）的兼容适配，以及生产环境的日志埋点与稳定性保障。

我们在过去多个企业项目中使用过 irabbi360/laravel-log-notifier 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 irabbi360/laravel-log-notifier 我们能提供哪些服务？

定制开发 / 二次开发

基于 irabbi360/laravel-log-notifier 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

与 irabbi360/laravel-log-notifier 相关的其它包

同方向 / 同关键字的高下载量 PHP Composer 包推荐，方便对比选型：

irabbi360/laravel-php-proxmox 17

A PHP package for Proxmox API integration

foxtes/alfabank-rest 1

Alfabank REST API integration

chrislorando/laravel-accurate 0

Laravel package for Accurate Online API integration.

rcx/datatables-laravel 0

Shared RCX Laravel DataTables UI and configuration helpers.

igne-agency/laravel-boot-up 0

Boot a Laravel project on any machine with one command: app:serve installs missing tools (PHP, Node, Composer, Herd, Docker), creates .env, sets up the database, runs migrations, builds assets, starts a queue worker and serves via Herd, Sail or artisan serve; app:down cleanly stops everything it sta

anselmokossa/filament-sentinel 0

Branded, diagnostic error pages (500, 403, 404, 419, 503) for Filament — native Filament UI, dark mode and translations out of the box.

irabbi360/laravel-log-notifier

包简介

关键字：