PHPackages                             laravisor/laravisor - 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 & Monitoring](/categories/logging)
4. /
5. laravisor/laravisor

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

laravisor/laravisor
===================

Security-first Laravel error monitoring with optional storage and client-side notifications

v1.0.0(3mo ago)312MITPHPPHP >=8.0

Since Jan 23Pushed 3mo agoCompare

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

READMEChangelog (1)Dependencies (1)Versions (2)Used By (0)

Laravisor
=========

[](#laravisor)

Laravisor is a Laravel-native error monitoring package that captures exceptions and sends instant email notifications directly from your application — with zero impact on application stability.

It works **out-of-the-box**, does **not require an API key**, and optionally integrates with the Laravisor Console for centralized error dashboards.

---

✨ Features
----------

[](#-features)

- Automatic exception capturing
- Instant email notifications
- Environment-based reporting
- Exception ignore list
- Safe, non-blocking execution
- Optional local database storage
- Optional Laravisor Console integration
- Laravel-first architecture

---

📋 Requirements
--------------

[](#-requirements)

- PHP 8.1+
- Laravel 9.x / 10.x / 11.x
- Mail configuration (SMTP / Mailer)

---

📦 Installation
--------------

[](#-installation)

Install via Composer:

```
composer require laravisor/laravisor
```

---

⚙️ Configuration
----------------

[](#️-configuration)

Publish the configuration file:

```
php artisan vendor:publish --tag=laravisor-config
```

This will create:

```
config/laravisor.php
```

---

🧠 IMPORTANT: Register the Exception Handler
-------------------------------------------

[](#-important-register-the-exception-handler)

Laravisor requires you to **explicitly report exceptions** using its handler.

### Step 1️⃣ Open Laravel Exception Handler

[](#step-1️⃣-open-laravel-exception-handler)

```
app/Exceptions/Handler.php
```

### Step 2️⃣ Add Laravisor reporting inside `register()` method

[](#step-2️⃣-add-laravisor-reporting-inside-register-method)

```
use Sam\Laravisor\Exception\LaravisorExceptionHandler;

public function register(Throwable $e): void
{
    $this->reportable(function (Throwable $e) {
        LaravisorExceptionHandler::report($e);
    });

    parent::report($e);
}
```

⚠️ **This step is mandatory**. Without this, Laravisor will NOT capture exceptions.

🔐 Required `.env` Variables
---------------------------

[](#-required-env-variables)

Laravisor requires the following environment variables to be defined in your application’s `.env` file.

```
LV_ENABLED=true
LV_ENVIRONMENTS=local
LV_NOTIFY_EMAILS="test_one@org.in,test_two@org.in,test_three@org.in"
```

### Description

[](#description)

VariableRequiredDescription`LV_ENABLED`✅ YesEnables or disables Laravisor globally`LV_ENVIRONMENTS`✅ YesComma-separated list of environments where Laravisor should capture errors (e.g. `production,staging,local`)`LV_NOTIFY_EMAILS`✅ YesComma-separated list of email addresses to receive error notifications⚠️ **Notes**

- If `LV_ENABLED=false`, Laravisor will not capture or notify errors.
- Errors are reported **only** when the current `APP_ENV` matches `LV_ENVIRONMENTS`.
- Email notifications depend entirely on `LV_NOTIFY_EMAILS`.

---

⚡ Quick Start (Email Notifications)
-----------------------------------

[](#-quick-start-email-notifications)

Once installed and handler is registered:

- Exceptions are captured automatically
- Emails are sent instantly
- No API key or dashboard setup required

Nothing else is required ✅

---

🛠 Configuration Example
-----------------------

[](#-configuration-example)

```
return [

    /*
    |--------------------------------------------------------------------------
    | Enable / Disable Laravisor
    |--------------------------------------------------------------------------
    */
    'enabled' => true,

    /*
    |--------------------------------------------------------------------------
    | Environments to Capture Errors
    |--------------------------------------------------------------------------
    */
    'environments' => ['production', 'staging', 'local'],

    /*
    |--------------------------------------------------------------------------
    | Notification Emails
    |--------------------------------------------------------------------------
    */
    'notify_emails' => [
        'dev@example.com',
    ],

    /*
    |--------------------------------------------------------------------------
    | Ignore Specific Exceptions
    |--------------------------------------------------------------------------
    */
    'ignore_exceptions' => [
        Illuminate\Auth\AuthenticationException::class,
        Symfony\Component\HttpKernel\Exception\NotFoundHttpException::class,
    ],

];
```

---

🌐 Laravisor Console (Optional)
------------------------------

[](#-laravisor-console-optional)

Laravisor Console is an **optional centralized dashboard** that allows you to:

- View grouped errors
- Inspect stack traces
- Track occurrences
- Resolve or ignore errors

🔑 **API key is required only for Console integration**📧 **Email notifications work without any key**

> If Console is not configured, Laravisor continues to work normally.

---

🛡 Safety & Stability Guarantees
-----------------------------------

[](#-safety--stability-guarantees)

Laravisor is designed to **never break your application**:

- All internal operations are wrapped in `try/catch`
- Network failures are silently ignored
- Email failures never affect requests
- Safe for queues, cron jobs, and schedulers

---

👨‍💻 Author
----------

[](#‍-author)

**Developed by Sudhanshu Mittal**

- GitHub:
- LinkedIn:

---

📄 License
---------

[](#-license)

MIT License © Laravisor

###  Health Score

35

—

LowBetter than 80% of packages

Maintenance80

Actively maintained with recent releases

Popularity9

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity39

Early-stage or recently created project

 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

Unknown

Total

1

Last Release

115d ago

### Community

Maintainers

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

---

Top Contributors

[![SAM2904](https://avatars.githubusercontent.com/u/51758881?v=4)](https://github.com/SAM2904 "SAM2904 (7 commits)")

### Embed Badge

![Health badge](/badges/laravisor-laravisor/health.svg)

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

###  Alternatives

[spatie/laravel-health

Monitor the health of a Laravel application

85810.0M83](/packages/spatie-laravel-health)[beyondcode/laravel-server-timing

Add Server-Timing header information from within your Laravel apps.

5712.0M1](/packages/beyondcode-laravel-server-timing)[rollbar/rollbar-laravel

Rollbar error monitoring integration for Laravel projects

14110.4M7](/packages/rollbar-rollbar-laravel)[yadahan/laravel-authentication-log

Laravel Authentication Log provides authentication logger and notification for Laravel.

416632.8k5](/packages/yadahan-laravel-authentication-log)[kitloong/laravel-app-logger

Laravel log for your application

101.2M8](/packages/kitloong-laravel-app-logger)[label84/laravel-auth-log

Log user authentication actions in Laravel.

3654.0k](/packages/label84-laravel-auth-log)

PHPackages © 2026

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