Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/es-code/larax
Larax is laravel package help us to log exceptions happened in our laravel applications and notify us with all the data we need to find out the cause of the problem when exception happened such as (the data did user sent it in body, headers ,user ip , user id and his guard)
https://github.com/es-code/larax
errorhandling exceptions laravel laravel-framework php
Last synced: 4 days ago
JSON representation
Larax is laravel package help us to log exceptions happened in our laravel applications and notify us with all the data we need to find out the cause of the problem when exception happened such as (the data did user sent it in body, headers ,user ip , user id and his guard)
- Host: GitHub
- URL: https://github.com/es-code/larax
- Owner: es-code
- Created: 2021-01-04T20:53:06.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2021-01-06T16:54:02.000Z (over 3 years ago)
- Last Synced: 2024-09-26T01:16:35.315Z (8 days ago)
- Topics: errorhandling, exceptions, laravel, laravel-framework, php
- Language: PHP
- Homepage:
- Size: 23.4 KB
- Stars: 25
- Watchers: 1
- Forks: 3
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# larax
Larax is laravel package help us to log exceptions happened in our laravel applications and notify us with all the data we need to find out the cause of the problem when exception happened such as (the data did user sent it in body, headers ,user ip , user id and his guard) .
[](https://packagist.org/packages/escode/larax)
[](https://packagist.org/packages/escode/larax)
## Installation
Add this package in composer.json.
```js
{
"require": {
"escode/larax": "1.*"
}
}
```
or run in terminal:
`composer require escode/larax`
### Add Larax Service Provider
open "/config/app.php" and append Escode\Larax\LaraxServiceProvider::class to providers array
`Example`
```php
'providers' => [
Escode\Larax\LaraxServiceProvider::class,
```
### Publish config file
`php artisan vendor:publish --tag=larax-config`
### Migrate database tables
`php artisan migrate`
### Make Larax Handle Exception
going to "/app/Exceptions/Handler.php" and make it extends from Escode\Larax\ExceptionHandler
`Example`
```php
use Escode\Larax\ExceptionHandler;
class Handler extends ExceptionHandler
{
```
## configration
open "/config/larax.php" this file help you to easily configure and control Larax.
### You can set your middleware that’s allow to access exceptions pages on website.
### You can set your middleware that’s allow to access exceptions pages over api.
### You can control data will be saved when exception happened.
### You can told Larax to detect user and save his id and his guard with exception data.
### You can ignore some keys “remove it from headers data” from request headers such as “Authorization”.
### You can ignore some fields “remove it from body data” from request body or query string such as “password , image , token”.
### You can told larax to notify you by send email when exception happened or not.
```php
return [
//set your middleware that's allow to access exceptions pages on website
'middleware'=>'auth',
//api middleware
'ApiMiddleware'=>'AuthLaraxApi',
//exceptions data you want to store it
'exception_data'=>[
'ip'=>true,
'url'=>true,
'headers'=>true,
'body'=>true,
],
// Note: if you enable detect user in exception larax will push StartSession::class and EncryptCookies::class in $middleware Kernel.php
// and you should be comment StartSession::class from $middlewareGroups => web
'detect_user'=>false,
//array of guards names will use it for detect user id
'guards'=>['auth'],
//ignore fields in request headers (this fields not saved in db)
'ignore_headers'=>[
'Authorization','cookie'
],
//ignore fields in request (this fields not saved in db)
'ignore_inputs'=>[
'image','password','password_confirmation'
],
//send email when exception happened
//enable send emails
'enable_email'=>true,
//email list you want send notify them with exception data
'emails'=>[
//example
//'[email protected]',
],
]
```
## How to use
open "http://localhost:8000/larax/exceptions"
to see the exceptions did happened in your application.
[](https://i.ibb.co/2yG3Qgf/Screen-Shot-2021-01-04-at-11-37-47-PM.png)
[](https://i.ibb.co/qmyr3Xr/Screen-Shot-2021-01-04-at-11-56-41-PM.png)
## Users
users in larax is used to allow users to read exceptions using Larax Api.
## Api
you can read your application exceptions data over Api
just do "GET" request to "http://localhost:8000/api/larax/exceptions" using user key as bearer token