PHPackages andrey-helldar/notify-exceptions - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Mail & Notifications](/categories/mail) 4. / 5. andrey-helldar/notify-exceptions Abandoned → [dragon-code/notify-exceptions](/?search=dragon-code%2Fnotify-exceptions)ArchivedLibrary[Mail & Notifications](/categories/mail) andrey-helldar/notify-exceptions ================================ Notify the site administrator of any errors through various channels of communication. v4.1.0(4y ago)135.6k1MITPHPPHP ^7.2.5|^8.0 Since Oct 8Pushed 3y ago1 watchersCompare [ Source](https://github.com/TheDragonCode/notify-exceptions)[ Packagist](https://packagist.org/packages/andrey-helldar/notify-exceptions)[ Fund](https://paypal.me/helldar)[ Fund](https://yoomoney.ru/to/410012608840929)[ RSS](/packages/andrey-helldar-notify-exceptions/feed)WikiDiscussions main Synced today READMEChangelog (10)Dependencies (13)Versions (26)Used By (0) Notifex ======= [](#notifex) [![Laravel Notify Exceptions](https://camo.githubusercontent.com/a9dd8a8586e66058fff69200d31885ff26c5756e435c4490d3497e9ffea01221/68747470733a2f2f707265766965772e647261676f6e2d636f64652e70726f2f546865447261676f6e436f64652f6e6f74696665782e7376673f6272616e643d6c61726176656c)](https://camo.githubusercontent.com/a9dd8a8586e66058fff69200d31885ff26c5756e435c4490d3497e9ffea01221/68747470733a2f2f707265766965772e647261676f6e2d636f64652e70726f2f546865447261676f6e436f64652f6e6f74696665782e7376673f6272616e643d6c61726176656c) [![Total Downloads](https://camo.githubusercontent.com/3e306fa69c883f7e72f512ea9c50cf9321c7452adefbc07dd8c8475ea5fb5f9c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f647261676f6e2d636f64652f6e6f746966792d657863657074696f6e732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/dragon-code/notify-exceptions) [![Latest Stable Version](https://camo.githubusercontent.com/96c370a12875ea422ec124f57537cecd33ff8cd6b86d79a74724161c7f80e24b/68747470733a2f2f706f7365722e707567782e6f72672f647261676f6e2d636f64652f6e6f746966792d657863657074696f6e732f762f737461626c653f666f726d61743d666c61742d737175617265)](https://packagist.org/packages/dragon-code/notify-exceptions) [![Latest Unstable Version](https://camo.githubusercontent.com/700aa93454ccd8c808c3710062d159a48b096d23175f324b6d70fa7456e6c549/68747470733a2f2f706f7365722e707567782e6f72672f647261676f6e2d636f64652f6e6f746966792d657863657074696f6e732f762f756e737461626c653f666f726d61743d666c61742d737175617265)](https://packagist.org/packages/dragon-code/notify-exceptions) [![License](https://camo.githubusercontent.com/69c00ef623d3ccf0458ee8e4a281e63efcda53e5e63a5e9de80eb0ba217c95f6/68747470733a2f2f706f7365722e707567782e6f72672f647261676f6e2d636f64652f6e6f746966792d657863657074696f6e732f6c6963656e73653f666f726d61743d666c61742d737175617265)](LICENSE) > You can use both [official plugins](https://laravel.com/docs/10.x/notifications) from the Laravel team and [plugins](https://laravel-notification-channels.com/) from the [community](https://laravel-notification-channels.com/). > > Of course, you can also create your own. Installation ------------ [](#installation) To get the latest version of `Notifex`, simply require the project using [Composer](https://getcomposer.org): ``` composer require dragon-code/notify-exceptions ``` Instead, you may of course manually update your `require` block and run `composer update`: ``` { "require": { "dragon-code/notify-exceptions": "^4.0" } } ``` You can also publish the config file to change implementations (ie. interface to specific class): ``` php artisan vendor:publish --provider="DragonCode\Notifex\ServiceProvider" ``` And call `php artisan migrate` command from console. Now you can use the `app('notifex')` method. ### Upgrade from `andrey-helldar/notify-exceptions` [](#upgrade-from-andrey-helldarnotify-exceptions) 1. Replace `"andrey-helldar/notify-exceptions": "^3.0"` with `"dragon-code/notify-exceptions": "^4.0"` in the `composer.json` file; 2. Replace `Helldar\Notifex` namespace prefix with `DragonCode\Notifex`; 3. Call the `composer update` console command. Configuration ------------- [](#configuration) ### Ingore bots [](#ingore-bots) By default, the package does not respond to errors created in the process of search bots. To enable error messages from bots, change the setting `ignore_bots` in [config/notifex.php](config/notifex.php) file. By default, false. ### Email [](#email) See [configuration](config/notifex.php) file. Example email message: [![email-message](https://user-images.githubusercontent.com/10347617/53572196-c003c700-3b7b-11e9-93e0-bff5aab01078.png)](https://user-images.githubusercontent.com/10347617/53572196-c003c700-3b7b-11e9-93e0-bff5aab01078.png) ### Jira [](#jira) If you need to create issues in the Jira, then you need to install the package [lesstif/php-jira-rest-client](https://github.com/lesstif/php-jira-rest-client): ``` composer require lesstif/php-jira-rest-client ``` [![2018-10-10_23-32-57](https://user-images.githubusercontent.com/10347617/46765597-187b1a80-cce8-11e8-91c4-ca2fffad88ff.png)](https://user-images.githubusercontent.com/10347617/46765597-187b1a80-cce8-11e8-91c4-ca2fffad88ff.png) ### Slack [](#slack) If you need to send messages in the Slack channel, then you need to install the package [laravel/slack-notification-channel](https://packagist.org/packages/laravel/slack-notification-channel): ``` composer require laravel/slack-notification-channel ``` ### Your notification services [](#your-notification-services) You can easily connect your notification services. To do this, in block `jobs` of file `config/notifex.php`, add a call to its job: ``` \DragonCode\Notifex\Jobs\ExampleJob::class ``` If you need to pass any parameters to your job, you can use an associative entry, where the key is the link to the job class, and the values are the parameters: ``` \DragonCode\Notifex\Jobs\ExampleJob::class => [ 'host' => env('EXAMPLE_HOST'), // http://127.0.0.1:8080 'user' => env('EXAMPLE_USER'), // 'foo' 'password' => env('EXAMPLE_PASS'), // 'bar' 'other_key' => env('EXAMPLE_OTHER_KEY'), // 12345 ], ``` Your job should inherit from the abstract class `DragonCode\Notifex\Abstracts\JobAbstract`. This will help to correctly create a class for work. To get the values of the settings you need to use the method `getConfig($class, $key)`: ``` $host = $this->getConfig(get_class(), 'host'); $user = $this->getConfig(get_class(), 'user'); $password = $this->getConfig(get_class(), 'password'); $other_key = $this->getConfig(get_class(), 'other_key'); // or add `config(string $key)` method: private function config(string $key) { return $this->getConfig(get_class(), $key); } $host = $this->config('host'); $user = $this->config('user'); $password = $this->config('password'); $other_key = $this->config('other_key'); ``` Examples of completed classes can be found here: - [ExampleJob](src/Jobs/ExampleJob.php) - [JiraJob](src/Jobs/JiraJob.php) It is worth noting that standard jobs of Laravel are used for the call: ``` php artisan make:job ``` They should remove the call interface `ShouldQueue` and extend the class: ``` // before use Illuminate\Contracts\Queue\ShouldQueue; class ExampleJob implements ShouldQueue {} // after use DragonCode\Notifex\Abstracts\JobAbstract; class ExampleJob extends JobAbstract {} ``` As the abstract class includes a call of all necessary classes and interfaces. It's all! Enjoy 😊 Using ----- [](#using) Add exception capturing to `app/Exceptions/Handler.php`: ``` public function report(Throwable $exception) { parent::report($exception); if (app()->bound('notifex') && $this->shouldReport($exception)) { app('notifex')->send($exception); } } ``` or just use in your code: ``` try { $foo = $bar } catch(\Exception $exception) { app('notifex')->send($exception); } ``` #### **IMPORTANT!** [](#important) To realize the possibility of saving an object to a database table, this object is processed before serialization. Due to the peculiarities of linking objects in PHP, serialization does not support the `Throwable` interface, and therefore, if you call method `app('notifex')->send($exception)` before processing a variable, the application may cause an error `Expected array for frame 0`. To avoid this, use method `parent::report($exception)` strictly **before** sending notifications. Test message ------------ [](#test-message) To verivy that Notifex is configured correctly and our integration is working, use `notifex:test` command: ``` php artisan notifex:test ``` A `DragonCode\Notifex\Exceptions\NotifexTestException` class will be thrown and captured by Notifex. The captured exception will appear in your configured email immediately. Support ------- [](#support) The package out of the box supports sending notifications to the following services: - **Email** *(default, enabled)* - **Slack** *(default, disabled)* - **Jira** *(default, disabled)* License ------- [](#license) This package is licensed under the [MIT License](LICENSE). ### Health Score 38 — LowBetter than 85% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity27 Limited adoption so far Community13 Small or concentrated contributor base Maturity77 Established project with proven stability Bus Factor2 2 contributors hold 50%+ of commits How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~49 days Recently: every ~20 days Total 25 Last Release 1574d ago Major Versions v1.1.2 → v2.0.02019-02-28 v2.2.2 → v3.0.02020-05-17 3.x-dev → v4.0.02021-11-16 PHP version history (5 changes)1.0.0PHP >=7.2 1.0.1PHP >=7.0 v2.0.0PHP ^7.1.3 v3.0.0PHP ^7.2.5 v3.2.0PHP ^7.2.5|^8.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/b77790e612f1c9beed1e1533e36eba4954fbd6da2a5c9f71e845cd0f5465f0ad?d=identicon)[Helldar](/maintainers/Helldar) --- Top Contributors [![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (25 commits)")[![actions-user](https://avatars.githubusercontent.com/u/65916846?v=4)](https://github.com/actions-user "actions-user (21 commits)")[![andrey-helldar](https://avatars.githubusercontent.com/u/10347617?v=4)](https://github.com/andrey-helldar "andrey-helldar (11 commits)")[![makeroi](https://avatars.githubusercontent.com/u/72909976?v=4)](https://github.com/makeroi "makeroi (1 commits)") --- Tags laravelemailslackexceptionsjiranotify exceptionsnotifex ### Embed Badge ![Health badge](/badges/andrey-helldar-notify-exceptions/health.svg) ``` [![Health](https://phpackages.com/badges/andrey-helldar-notify-exceptions/health.svg)](https://phpackages.com/packages/andrey-helldar-notify-exceptions) ``` ### Alternatives [laravel/cashier Laravel Cashier provides an expressive, fluent interface to Stripe's subscription billing services. 2.5k25.9M107](/packages/laravel-cashier)[roots/acorn Framework for Roots WordPress projects built with Laravel components. 9682.1M97](/packages/roots-acorn)[laravel/pulse Laravel Pulse is a real-time application performance monitoring tool and dashboard for your Laravel application. 1.7k12.1M99](/packages/laravel-pulse)[laravel-notification-channels/telegram Telegram Notifications Channel for Laravel 1.1k3.4M35](/packages/laravel-notification-channels-telegram)[laravel-notification-channels/discord Laravel notification driver for Discord. 2371.3M11](/packages/laravel-notification-channels-discord)[spatie/laravel-health Monitor the health of a Laravel application 85810.0M83](/packages/spatie-laravel-health) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)