narolalabs/error-lens

See, Understand, and Handle Laravel Errors using ErrorLens

v2.6.2 2024-08-01 12:47 UTC

README

Latest Version on Packagist Total Downloads

ErrorLens

Version Compatibility

  • PHP (7.3, 7.4, 8.0, 8.1)
  • Laravel (8.x, 9.x, 10.x, 11x)

Installation

Please adhere to the following instructions meticulously to successfully complete the installation process.

Package Installation (Required)

composer require narolalabs/error-lens

Install recommended migration, assets and seeder with single command. (Required)

php artisan error-lens:install

Note: If you wish to reset the error log tables, you can use the --fresh flag. For example: php artisan error-lens:install --fresh.

To safeguard against unauthorized access, you can set or reset the username and password for authentication. (Highly recommended but optional)

php artisan error-lens:authentication

Once you have completed the above steps, clear the cache using the following command.

php artisan config:clear

Important Instructions: If you are installing in a development environment and the cache is not cleared, please re-run the php artisan serve command.

Finally, To view all the error logs, visit the https://domain.com/error-lens

Upgrade

While you upgrade the package and wish to install recommended configurations, you can do that with a single command.

php artisan error-lens:update

Additional Configurations

In case you face any issues with the above installation and upgrade commands, you can resolve them by running the individual commands provided below.

Publish and run migration

php artisan vendor:publish --tag="error-lens-migrations"
php artisan migrate

Publish Assets

php artisan vendor:publish --tag="error-lens-assets" --force

If you are not aware or confused about the setting configurations, you can publish the seeder and run it.

php artisan vendor:publish --tag=error-lens-seeds
php artisan db:seed --class=ErrorLensConfigurationSeeder

Screenshots

Error Lens - Dashboard

Error Lens - Error modal view

Error Lens - Full page error view

Error Lens - Configuration

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

License

The MIT License (MIT). Please see License File for more information.