julienbourdeau / route-usage
Log what routes were used and when. Easily figure out if one hasn't been called in a long time (and delete it! 🥳)
Installs: 36 513
Dependents: 0
Suggesters: 0
Security: 0
Stars: 276
Watchers: 5
Forks: 15
Open Issues: 1
Requires
- php: >= 7.1
- laravel/framework: >= 5.8
Requires (Dev)
- orchestra/testbench: 3.8.*
- phpunit/phpunit: ^7.0
README
This package keeps track of all requests to know what controller method, and when it was called. The goal is not to build some sort of analytics but to find out if there are unused endpoints or controller method.
After a few years, any projects have dead code and unused endpoint. Typically, you removed a link on your frontend, nothing ever links to that old /special-page
. You want to remove it, but you're not sure.
Have look at the route_usage
table and figure out when this page was accessed for the last time. Last week? Better keep it for now. 3 years ago? REMOVE THE CODE! 🥳
Installation
You can install the package via composer:
composer require julienbourdeau/route-usage
Run migrations to create the new route_usage
table.
php artisan migrate
Publish configuration
php artisan vendor:publish --provider="Julienbourdeau\RouteUsage\RouteUsageServiceProvider"
Usage
To access the route usage, you can do it in your terminal with the command.
php artisan usage:route
To access the HTML table, you'll first need to define who can access it. By default,
it's available only on local
environment.
In your AuthServiceProvide
, in the boot
method, define who can access this page:
Gate::define('viewRouteUsage', function ($user) { return $user->isSuperAdmin(); });
Then, head over to yourapp.tld/route-usage
.
Configuration
excluding-regex
Here you may specify regex to exclude routes from being logged. Typically, you want may want to exclude routes from packages or dev controllers. The value must be a valid regex or anything falsy.
Notes
- I only logs request with a 2xx or 3xx HTTP response. I don't think the rest makes sense. Your opinion is welcome!
- In the very first version, I was incrementing a
count
attribute. I removed it because I think it gives a wrong information. If it was used a lot because but last access was a year ago, it gives a false sense of importance to this unused route.
Road to 1.0 release
Less SQL queries
I'll like to reduce the number of SQL queries performed. Typically, if a route is called, we don't need to log usage for the next 5 minutes. I'm thinking we could use some cache or split the data: attributes in mysql but last used date in Redis.
💡 Feel free to open an issue to discuss your ideas.
More package to ignore
Today, we ignore routes from Nova or Debugbar because there is nothing you can do about these routes. I'd like to support more packages out of the box.
📦 What package would you like to see added?
About
Changelog
Please see CHANGELOG for more information what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security
If you discover any security related issues, please email julien@sigerr.org instead of using the issue tracker.
Credits
Laravel Package Boilerplate
This package was generated using the Laravel Package Boilerplate.
License
The MIT License (MIT). Please see License File for more information.