PHPackages vikasrinvi/laravel-bug-watcher - 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. vikasrinvi/laravel-bug-watcher ActiveLibrary vikasrinvi/laravel-bug-watcher ============================== to send the mail when error occured v2.7(2y ago)024PHP Since May 15Pushed 2y ago1 watchersCompare [ Source](https://github.com/vikasrinvi/laravel-bug-watcher)[ Packagist](https://packagist.org/packages/vikasrinvi/laravel-bug-watcher)[ RSS](/packages/vikasrinvi-laravel-bug-watcher/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (9)Dependencies (2)Versions (19)Used By (0) laravel-bug-watcher =================== [](#laravel-bug-watcher) [![License](https://camo.githubusercontent.com/08cef40a9105b6526ca22088bc514fbfdbc9aac1ddbf8d4e6c750e3a88a44dca/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d626c75652e737667)](https://opensource.org/licenses/MIT) This is package is made for the developer. It sends the error message in email whenever there is any bug in the application and also create a clickup task in the clickup. Features -------- [](#features) - Send Email with the details of the bug. - Create a task in the clickUp with bug report Future Scope ------------ [](#future-scope) - Can be integrated with the AI like chatgpt to which can provide the optimum solution for the bug. - We can store the error log and create a UI with some route so that all the previous bug on the system can be tracked Requirements ------------ [](#requirements) - PHP >= 8.1 - Laravel >= 9.0 Installation ------------ [](#installation) Run the following command ``` composer require vikasrinvi/laravel-bug-watcher ``` After updating composer, add the service provider to the providers array in config/app.php > you can skip adding the provider to config/app.php as it will be auto-discovered ``` Vikasrinvi\LaravelBugWatcher\LaravelBugWatcherServiceProvider::class, ``` Then in app/Exceptions/Handler.php replace ``` use Illuminate\Foundation\Exceptions\Handler as ExceptionHandler; ``` with ``` use Vikasrinvi\LaravelBugWatcher\ErrorHandler as ExceptionHandler; ``` Configuration ------------- [](#configuration) To publish the config file ``` php artisan vendor:publish --provider="Vikasrinvi\LaravelBugWatcher\LaravelBugWatcherServiceProvider" --tag="config" ``` That will create a config file for you in config/laravel-bug-watcher.php Default configuration: ``` 'ErrorEmail' => [ 'email' => true, 'dontEmail' => [], 'throttle' => true, 'throttleCacheDriver' => env('CACHE_DRIVER', 'file'), 'throttleDurationMinutes' => 5, 'dontThrottle' => [], 'globalThrottle' => true, 'globalThrottleLimit' => 20, 'globalThrottleDurationMinutes' => 30, 'toEmailAddress' => null, 'fromEmailAddress' => null, 'emailSubject' => config('app.name'). " :- Error Occured " ], 'ClickUp' =>[ 'createTask' => true, 'token' => env('CLICKUP_ACCESS_TOKEN', null), 'team_name' => env('CLICKUP_TEAM_NAME', null), 'folder_name' =>env('CLICKUP_FOlDER_NAME', null), 'folder_id' => env('CLICKUP_FOlDER_ID', null), 'list_name' => env('CLICKUP_LIST_NAME', null), 'list_id' => env('CLICKUP_LIST_ID', null) ] ``` Basic Usage ----------- [](#basic-usage) #### Basic Config of clickup task [](#basic-config-of-clickup-task) - createTask (bool) - Enable or disable creating task in the clickup. - token (string) - Token from the clickup - Team name (string) - Team name is the team in which the project is created we need to get it from the click, it it also the workspace name - Folder name (string) - This is the project name in the click up - list name - It is task parent of the task under which task will be created in the clickup **Important:** There should be a Status under the list call 'BACKLOG' and ther should a label create with the name 'bug. #### Basic Config of email [](#basic-config-of-email) - email (bool) - Enable or disable emailing of errors/exceptions - dontEmail (array) - This works exactly like laravel's $dontReport variable documented here: \]#the-exception-handler under Ignoring Exceptions By Type. Keep in mind also any exceptions under laravel's $dontReport also will not be emailed - throttle (bool) - Enable or disable throttling of exception emails. Throttling is only performed if its been determined the exact same exception/error has already been emailed by checking the cache. Errors/Exceptions are determined to be unique by exception class + exception message + exception code - throttleCacheDriver (string) - The cache driver to use for throttling, by default it uses CACHE\_DRIVER from your env file - throttleDurationMinutes (int) - The duration in minutes of the throttle for example if you put 5 and a BadMethodCallException triggers an email if that same exception is thrown again it will not be emailed until 5 minutes have passed - dontThrottle (array) - This is the same as dontEmail except provide a list of exceptions you do not wish to throttle ever even if throttling is turned on - globalThrottle (bool) - Enable or disable whether you want to globally throttle the number of emails you can receive of all exception types by this application - globalThrottleLimit (int) - The the maximum number of emails you want to receive in a given period. - throttleDurationMinutes (int) - The duration in minutes of the global throttle for example if you put in 30 and have 10 for your globalThrottleLimit when the first email is sent out a 30 minute timer will commence once you reach the 10 email threshold no more emails will go out for that 30 minute period. - toEmailAddress (string|array) - The email(s) to send the exceptions emails to such as the dev team - fromEmailAddress (string) - The email address these emails should be sent from such as . - emailSubject (string) - The subject of email, leave NULL to use default Default Subject: Error Occured config('app.name', 'unknown').' ('.config('app.env', 'unknown').')' **Note:** the dontReport variable from **app/Exceptions/Handler.php** file will also not be emailed as it's assumed if they are not important enough to log then they also are not important enough to email **Important:** You must fill out a toEmailAddress and fromEmailAddress or you will not receive emails. Advanced Usage -------------- [](#advanced-usage) ### Changing the view [](#changing-the-view) If you published your view using the command below you will be able to change the look of the exception email by modifying your view in **resources/views/vendor/laravel-bug-watcher/emailException.blade.php**follow this to publish the view and the you can modify it ``` php artisan vendor:publish --provider="php artisan vendor:publish --provider="Vikasrinvi\LaravelBugWatcher\LaravelBugWatcherServiceProvider" --tag="views" ``` Important notes --------------- [](#important-notes) Make sure you have configured your Mail setting in the env so that Mail can be send ``` MAIL_DRIVER=smtp MAIL_HOST=smtp.mailtrap.io MAIL_PORT=2525 MAIL_USERNAME=your-user-string MAIL_PASSWORD=your-password-string MAIL_ENCRYPTION=null ``` ### Health Score 24 — LowBetter than 32% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity6 Limited adoption so far Community7 Small or concentrated contributor base Maturity53 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure 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 ~0 days Total 16 Last Release 1084d ago Major Versions v1.9 → v2.12023-05-22 ### Community Maintainers ![](https://www.gravatar.com/avatar/60f5ba1bfdb658912f3078b2506ee5a61f08349a302c4847e7dd0087bb582d13?d=identicon)[vikasrinvi](/maintainers/vikasrinvi) --- Top Contributors [![vikasrinvi](https://avatars.githubusercontent.com/u/32789328?v=4)](https://github.com/vikasrinvi "vikasrinvi (7 commits)") ### Code Quality TestsPest ### Embed Badge ![Health badge](/badges/vikasrinvi-laravel-bug-watcher/health.svg) ``` [![Health](https://phpackages.com/badges/vikasrinvi-laravel-bug-watcher/health.svg)](https://phpackages.com/packages/vikasrinvi-laravel-bug-watcher) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)