Optimize Laravel Performance with Config and Route Caching

Summary: Use Artisan commands to boost Laravel speed.

Laravel is one of the most popular PHP frameworks for web application development. It offers an elegant syntax, a rich ecosystem, and powerful features out-of-the-box. However, as your application grows, performance can become a concern—especially when serving a large number of requests or deploying to resource-constrained environments.

One of the simplest ways to supercharge your Laravel app's performance is by leveraging Laravel's built-in caching mechanisms for configuration and routing. In this post, we'll explore how config and route caching work, why they're essential, and how to use them effectively with Artisan commands.

Why Cache Configs and Routes?

Every HTTP request to your Laravel app needs to:

  1. Load and parse numerous configuration files.
  2. Load and process all route definitions.

In development, this is expected—Laravel remains flexible so you can change files and see immediate effects. But in production, reloading everything with every request costs precious milliseconds.

Config and route caching lets you compile these files into optimized cache files, significantly reducing bootstrap time.

Configuration Caching

What Is Configuration Caching?

Laravel applications load multiple configuration files from the config/ directory. By default, Laravel reads every configuration file on each request, parsing PHP arrays to build your configuration repository.

Configuration caching combines all these files into a single file, reducing disk I/O and PHP parsing overhead.

How to Cache Configurations

Run the following Artisan command in your project root:

php artisan config:cache

This command does the following:

  • Combines all config files into one cache file at bootstrap/cache/config.php.
  • Cleans existing caches before building a new one.

Tip: Anytime you change a config file or any environment variables, you must re-run this command to update the cache!

Clearing the Config Cache

If you want to clear the configuration cache—for troubleshooting or development—use:

php artisan config:clear

Route Caching

What Is Route Caching?

Laravel's route definitions can become complex, especially when using closures, middleware, route groups, or resource controllers. On every request, Laravel parses all route files, which can add up in bigger applications.

Route caching compiles all routes into a single PHP file, dramatically speeding up route registration.

How to Cache Routes

To cache routes with Artisan, use:

php artisan route:cache

Laravel generates a file at bootstrap/cache/routes.php containing a pre-compiled set of routes.

Warning: Only use route caching if all your routes are defined in controller classes. Routes written as Closures cannot be cached and will cause errors.

Clearing the Route Cache

If you add/edit routes, always clear the cache before re-caching:

php artisan route:clear

Best Practices for Caching

  • Cache only in production: Caching is ideal for stable, production environments. In development, you’ll want to see changes immediately.
  • Automate caching in deployments: Add php artisan config:cache and php artisan route:cache to your deployment scripts.
  • Monitor cache validity: Changing environment variables or configs? Run the caching commands again.
  • Controller-based routes: Prefer controller actions instead of closure routes for cacheability and maintainability.

Automating with Composer Scripts

For seamless deployments, consider adding cache commands to your composer.json scripts:

"scripts": {
  "post-install-cmd": [
    "@php artisan config:cache",
    "@php artisan route:cache"
  ],
  "post-update-cmd": [
    "@php artisan config:cache",
    "@php artisan route:cache"
  ]
}

Conclusion

Optimizing your Laravel application for speed should always begin with the low-hanging fruit: configuration and route caching. By simply running a few Artisan commands before going live, you can dramatically reduce request times and improve scalability.

Summing Up:

  • Use php artisan config:cache for config performance.
  • Use php artisan route:cache for route performance.
  • Re-run these after any relevant code or config changes.

Take advantage of Laravel's built-in features and unlock a faster, more resilient application today!

Happy caching! 🚀

Back to All Articles