guanguans/laravel-exception-notify

Monitor exception and report to the notification channels(Dump、Log、Mail、AnPush、Bark、Chanify、DingTalk、Discord、Gitter、GoogleChat、IGot、Lark、Mattermost、MicrosoftTeams、NowPush、Ntfy、Push、Pushback、PushBullet、PushDeer、PushMe、Pushover、PushPlus、QQ、RocketChat、ServerChan、ShowdocPush、SimplePush、Slack、Telegram、We

5.1.11 2025-03-26 13:06 UTC

Requires

• php: >=8.0
• guanguans/notify: ^3.2
• laravel/framework: ^9.52 || ^10.0 || ^11.0 || ^12.0

Requires (Dev)

• adhocore/json-fixer: ^1.0
• azjezz/psl: ^1.9 || ^2.0 || ^3.0
• bamarni/composer-bin-plugin: ^1.8
• brainmaestro/composer-git-hooks: ^3.0
• composer/semver: ^3.4
• cweagans/composer-patches: ^1.7
• driftingly/rector-laravel: ^2.0
• ergebnis/composer-normalize: ^2.45
• ergebnis/json-printer: ^3.7
• ergebnis/rector-rules: ^1.3
• guanguans/ai-commit: dev-main
• guanguans/monorepo-builder-worker: ^1.4
• laravel/facade-documenter: dev-main
• mockery/mockery: ^1.6
• nette/utils: ^4.0
• orchestra/testbench: ^7.53 || ^8.0 || ^9.0 || ^10.0
• pestphp/pest: ^1.23 || ^2.0 || ^3.0
• pestphp/pest-plugin-faker: ^1.0 || ^2.0 || ^3.0
• pestphp/pest-plugin-laravel: ^1.4 || ^2.0 || ^3.0
• php-mock/php-mock-phpunit: ^2.13
• phpstan/extension-installer: ^1.4
• phpstan/phpstan: ^2.1
• phpstan/phpstan-deprecation-rules: ^2.0
• phpstan/phpstan-webmozart-assert: ^2.0
• rector/rector: ^2.0
• rector/swiss-knife: ^2.1
• rector/type-perfect: ^2.0
• shipmonk/composer-dependency-analyser: ^1.8
• shipmonk/phpstan-baseline-per-identifier: ^2.1
• spatie/pest-plugin-snapshots: ^1.1 || ^2.0
• spaze/phpstan-disallowed-calls: ^4.4
• symplify/phpstan-extensions: ^12.0
• symplify/phpstan-rules: ^14.4
• symplify/vendor-patches: ^11.4
• tomasvotruba/class-leak: ^2.0
• tomasvotruba/type-coverage: ^2.0
• yamadashy/phpstan-friendly-formatter: ^1.2

MIT

• guanguans

• log
• mail
• dump
• email
• exception
• error
• logger
• sdk
• notification
• monitor
• bot
• laravel
• push
• notify
• notifier
• pushover
• qq
• slack
• pushbullet
• gitter
• telegram
• 微信
• discord
• dingtalk
• Mattermost
• 企业微信
• simplepush
• 钉钉
• lark
• wework
• rocketchat
• zulip
• 钉钉群机器人
• Bark
• Server酱
• 息知
• chanify
• serverChan
• xiZhi
• 飞书群机器人
• 飞书
• 企业微信群机器人
• Ntfy
• googleChat
• pushPlus
• pushBack
• iGot
• PushDeer
• QQ 频道机器人
• 一封传话
• MicrosoftTeams
• NowPush
• ShowdocPush
• YiFengChuanHua
• AnPush
• WPush
• PushMe

README

Monitor exception and report to the notification channels(Dump、Log、Mail、AnPush、Bark、Chanify、DingTalk、Discord、Gitter、GoogleChat、IGot、Lark、Mattermost、MicrosoftTeams、NowPush、Ntfy、Push、Pushback、PushBullet、PushDeer、PushMe、Pushover、PushPlus、QQ、RocketChat、ServerChan、ShowdocPush、SimplePush、Slack、Telegram、WeWork、WPush、XiZhi、YiFengChuanHua、Zulip).

Related repositories

• https://github.com/guanguans/notify
• https://github.com/guanguans/yii-log-target

Requirement

• PHP >= 8.0

Installation

composer require guanguans/laravel-exception-notify --ansi -v

Configuration

Publish files(optional)

php artisan vendor:publish --provider="Guanguans\\LaravelExceptionNotify\\ExceptionNotifyServiceProvider" --ansi -v

Apply for channel authentication information

• Notify(30+)
• Dump(for debugging exception report)
• Log
• Mail

Configure channels in the config/exception-notify.php and .env file

EXCEPTION_NOTIFY_CHANNEL=stack
EXCEPTION_NOTIFY_STACK_CHANNELS=log,slack,weWork
EXCEPTION_NOTIFY_SLACK_WEBHOOK=https://hooks.slack.com/services/TPU9A9/B038KNUC0GY/6pKH3vfa3mjlUPcgLSjzR
EXCEPTION_NOTIFY_WEWORK_TOKEN=73a3d5a3-ceff-4da8-bcf3-ff5891778

Usage

Test whether exception can be monitored and reported to notification channel

php artisan exception-notify:test --channel=dump --job-connection=sync
php artisan exception-notify:test
php artisan exception-notify:test -v

📸 Notification examples

🧐 details

discord	slack	telegram
lark	mail	weWork

Skip report

app/Providers/AppServiceProvider.php

<?php

use Guanguans\LaravelExceptionNotify\Facades\ExceptionNotify;
use Illuminate\Support\Arr;

public function boot(): void
{
    ExceptionNotify::skipWhen(static fn (\Throwable $throwable) => Arr::first(
        [
            \Symfony\Component\HttpKernel\Exception\HttpException::class,
            \Illuminate\Http\Exceptions\HttpResponseException::class,
        ],
        static fn (string $exception): bool => $throwable instanceof $exception
    ));
}

Extend channel

app/Providers/AppServiceProvider.php

<?php

use Guanguans\LaravelExceptionNotify\Contracts\ChannelContract;
use Guanguans\LaravelExceptionNotify\Facades\ExceptionNotify;
use Illuminate\Container\Container;

public function boot(): void
{
    ExceptionNotify::extend('YourChannelName', function (Container $container): ChannelContract {
        return 'Instance of the `Guanguans\LaravelExceptionNotify\Contracts\ChannelContract`.';
    });
}

Testing

composer test

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

• guanguans
• All Contributors

Thanks

License

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