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! 🥳
You can install the package via composer:
composer require julienbourdeau/route-usageRun migrations to create the new route_usage table.
php artisan migratePublish configuration
php artisan vendor:publish --provider="Julienbourdeau\RouteUsage\RouteUsageServiceProvider"To access the route usage, you can do it in your terminal with the command.
php artisan usage:routeTo 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.
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.
- 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
countattribute. 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.
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?
Please see CHANGELOG for more information what has changed recently.
Please see CONTRIBUTING for details.
If you discover any security related issues, please email [email protected] instead of using the issue tracker.
This package was generated using the Laravel Package Boilerplate.
The MIT License (MIT). Please see License File for more information.