PHPackages                             sulaimanmisri/easy-detect - 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. [Logging &amp; Monitoring](/categories/logging)
4. /
5. sulaimanmisri/easy-detect

ActiveLibrary[Logging &amp; Monitoring](/categories/logging)

sulaimanmisri/easy-detect
=========================

Get exception report in your Laravel application before your user report it.

v1.3.1(1y ago)31171[1 issues](https://github.com/msulaimanmisri/easy-detect/issues)MITPHPPHP ^8.1

Since Feb 17Pushed 1y ago1 watchersCompare

[ Source](https://github.com/msulaimanmisri/easy-detect)[ Packagist](https://packagist.org/packages/sulaimanmisri/easy-detect)[ RSS](/packages/sulaimanmisri-easy-detect/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (7)Dependencies (1)Versions (9)Used By (0)

[![EasyDetect Image](public/easy-detect.png)](public/easy-detect.png)

Easy Detect - Laravel Error Notification Package
================================================

[](#easy-detect---laravel-error-notification-package)

Easy Detect is a Laravel package designed to simplify error monitoring in your application. It automatically captures and sends email notifications whenever an exception occurs, providing detailed error reports to help developers quickly identify and resolve issues.

Tip

Found this package useful? Don't forget to ⭐ star the repository and share your feedback!

Features
--------

[](#features)

- Automatic error email notifications for unhandled exceptions.
- Customizable email recipients.
- Built-in anti-spam mechanism to prevent excessive notifications.
- Configurable email template for better UI/UX.

[![EasyDetect Image](public/easy-detect-example.png)](public/easy-detect-example.png)

About the Author
----------------

[](#about-the-author)

Hi, I'm Sulaiman Misri, a Senior Executive based in Kuala Lumpur, Malaysia. If you find this package useful, feel free to explore my [portfolio](https://sulaimanmisri.com) for more information about my freelance services and open-source contributions.

Requirements
------------

[](#requirements)

- Laravel 10.x or higher
- PHP 8.2 or higher
- Mail configuration set up in .env

Installation
------------

[](#installation)

Follow these steps to install Easy Detect in your Laravel application:

### 1️⃣ Install via Composer

[](#1️⃣-install-via-composer)

```
composer require sulaimanmisri/easy-detect

```

### 2️⃣ Publish Configuration File

[](#2️⃣-publish-configuration-file)

```
php artisan vendor:publish --tag=easy-detect-config

```

### 3️⃣ Publish Email View Template (optional)

[](#3️⃣-publish-email-view-template-optional)

```
php artisan vendor:publish --tag=easy-detect-views

```

### 4️⃣ Configure Email Recipients

[](#4️⃣-configure-email-recipients)

Update your .env file with the email addresses where error notifications should be sent. You can specify multiple recipients separated by commas:

```
EASY_DETECT_RECIPIENTS="userone@email.com, usertwo@email.com"

```

### 5️⃣ Set Up Queue Configuration (Recommended)

[](#5️⃣-set-up-queue-configuration-recommended)

To ensure email notifications are processed in the background without affecting application performance, set your queue connection to database:

```
QUEUE_CONNECTION=database

```

Tip

Important: Background processing ensures better reliability and allows for failed job handling.

Usage
-----

[](#usage)

### Enabling/Disabling Notifications

[](#enablingdisabling-notifications)

You can toggle email reporting by modifying the turn\_on configuration in `config/easy-detect.php` :

```
'turn_on' => false, // Set to true to enable error notifications

```

Important

Important: It is recommended to disable error notifications in local or staging environments to avoid unnecessary emails. Enable it in production for real-time error tracking.

### Automatic Error Reporting

[](#automatic-error-reporting)

Once installed, `Easy Detect` will automatically capture and send email notifications for unhandled exceptions. No additional code is required!

Configuration
-------------

[](#configuration)

Easy Detect comes with a configuration file (config/easy-detect.php) that allows you to customize its behavior:

### Anti-Spam Mechanism

[](#anti-spam-mechanism)

To prevent excessive error emails, you can cache exceptions. This ensures that the same error is only reported once within a defined period:

```
'cache_duration' => 60, // Cache duration in minutes

```

### Customizing the Email Template

[](#customizing-the-email-template)

If you want to modify the email template:

1. Publish the views (already covered in step 3 of installation).
2. Edit the published template file located in resources/views/vendor/easy-detect.

Note

Note: The default email template contains essential error details. It is recommended to only adjust the UI/UX, not the actual error data structure, to maintain the accuracy of reports.

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance37

Infrequent updates — may be unmaintained

Popularity15

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity52

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 ~1 days

Total

7

Last Release

438d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/b90923eece16811793cf6e8696d1f2db7252f1b3cf60f502b0c8e15710d0b057?d=identicon)[serversulaiman](/maintainers/serversulaiman)

---

Top Contributors

[![msulaimanmisri](https://avatars.githubusercontent.com/u/47172118?v=4)](https://github.com/msulaimanmisri "msulaimanmisri (16 commits)")

### Embed Badge

![Health badge](/badges/sulaimanmisri-easy-detect/health.svg)

```
[![Health](https://phpackages.com/badges/sulaimanmisri-easy-detect/health.svg)](https://phpackages.com/packages/sulaimanmisri-easy-detect)
```

###  Alternatives

[overtrue/laravel-query-logger

A dev tool to log all queries for laravel application.

413307.5k6](/packages/overtrue-laravel-query-logger)[guanguans/laravel-exception-notify

Monitor exception and report to the notification channels(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、ZohoCliq、ZohoCliqWebHook、Zulip).

14642.7k1](/packages/guanguans-laravel-exception-notify)[regulus/activity-log

A clean and simple Laravel 5 activity logger for monitoring user activity on a website or web application.

164220.1k2](/packages/regulus-activity-log)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
