Download the PHP package tishmalo/escalation-matrix without Composer
On this page you can find all versions of the php package tishmalo/escalation-matrix. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download tishmalo/escalation-matrix
More information about tishmalo/escalation-matrix
Files in tishmalo/escalation-matrix
Package escalation-matrix
Short Description Escalation Matrix Package for Laravel
License MIT
Informations about the package escalation-matrix
Escalation Matrix Package
A robust error handling and escalation system for Laravel applications. This package captures exceptions, prioritizes them, and sends notifications via Email and SMS (optional). It also features a standalone support ticket system via a Driver pattern.
Features
- 🚨 Prioritized Error Handling: Automatically categorizes errors as Critical, High, Medium, or Low.
- 📧 Email Notifications: sends detailed error reports to configured contacts.
- 📱 SMS Alerts: Optional integration with Africa's Talking for critical mobile alerts.
- 🎫 Support Ticket Driver: Plug-and-play interface to connect with any support ticket system.
- 🖥️ Standalone UI: Built-in interface at
/ticketsto view and manage internal tickets. - ⚙️ Configurable: Rate limiting, ignored exceptions, and custom escalation matrices.
Installation
You can install the package via composer:
Setup
-
Publish Configuration:
-
Run Migrations: The package uses a local database ticket system by default. Run migrations to create the required table:
-
Configure Escalation Matrix: Edit
config/escalation.phpto set up your notification contacts, priorities, and channels. - Setup Ticket Authentication (Important!):
The
/ticketsinterface is protected and requires authentication. Choose one of the methods below:
Ticket Authentication Setup
Option 1: For Apps WITH Laravel Authentication (Recommended)
If your application has user authentication (Breeze, Jetstream, Sanctum, etc.), configure allowed users:
Or use roles (works with Spatie Permission, Laravel's built-in roles, etc.):
How it works:
- Users must log in to your application first
- Package checks if the logged-in user's email is in allowed list OR has an allowed role
- No additional login required - uses your app's existing authentication
Option 2: For Apps WITHOUT Authentication (Password-Based)
If your application doesn't have authentication, set up a password:
This command will:
- Prompt you to enter a password (min 8 characters)
- Generate a bcrypt hash
- Show you what to add to your
.envfile
Add the generated hash to .env:
How it works:
- Users visit
/ticketsand see a login form - They enter the password you set
- Session-based authentication (login once per browser session)
- To change password, run
php artisan escalation:set-passwordagain
Disable Authentication (Not Recommended for Production)
To disable authentication (only for local development):
⚠️ Warning: This exposes sensitive error data (stack traces, user info, IPs) to anyone who can access your application.
Custom Support Ticket Driver (Optional)
By default, the package uses LocalTicketDriver which stores tickets in your database. To integrate with an external ticketing system:
-
Implement the Driver Interface:
- Bind Your Custom Driver:
In your
AppServiceProvider:
Usage
✨ Automatic Exception Capture (Zero Configuration Required)
The package works automatically! Once installed and configured, it will capture and process ALL exceptions without any code changes.
The package automatically registers with Laravel's exception handler using the reportable() method and processes exceptions based on your config/escalation.php settings.
To disable automatic reporting:
Or in config/escalation.php:
Manual Integration (Optional)
If you prefer manual control or disabled auto-reporting, you can manually trigger the escalation:
Using Facade:
Using Service Container:
Viewing and Managing Tickets
Access the ticket management interface at /tickets to:
- View all tickets with their priorities and statuses
- Click on individual tickets to see full details
- Change ticket status via dropdown (Open, In Progress, Resolved, Closed)
Updating the Package
When updating the package, if you have previously published the views, republish them to get the latest updates:
License
The MIT License (MIT). Please see License File for more information.
All versions of escalation-matrix with dependencies
illuminate/support Version ^10.0|^11.0
illuminate/database Version ^10.0|^11.0
illuminate/mail Version ^10.0|^11.0