Support the ongoing development of Laravel.io →

Why Laravel uses caches and how to clear them for debugging

10 Sep, 2022 2 min read 291 views

Some performance issues at scale can come from repeatedly computing values for Laravel's bootstrapping process, which occurs at each request your visitors make (unless you're using Octane). Therefore, caching those values is essential to help your application stays fast. Sometimes though, problems happen, and cache gets in the way of debugging. Let's see how we can clear every cache Laravel uses.

This is an article originally posted on Benjamin Crozat's blog.

Why and how to clear config cache in Laravel

Some config values are fetched from your environment file and it can be a bit slow. Luckily, Laravel can cache them to help us speed up our applications.

php artisan config:clear

Why and how to clear events cache in Laravel

Laravel's automatic event discovery is beneficial. You don't need to register listeners manually anymore thanks to this tiny change you can make in your EventServiceProvider.

…

class EventServiceProvider extends ServiceProvider
{
    …

    public function shouldDiscoverEvents() : bool
    {
        return true;
    }
}

When going into production, you can cache auto-discovered events for maximum performance.

php artisan event:clear

Why and how to clear routes cache in Laravel

Routes are an essential part of your web application or API. Resolving a route can take time if you have a lot of them and as you guessed, caching helps for that.

php artisan route:clear

Why and how to clear scheduled tasks cache in Laravel

Let's say you have a recurring task that takes so much time to complete it will overlap with its next occurrence. You can prevent it until the previous one has finished:

$schedule->command('some:task')->withoutOverlapping();

Behind the scenes, Laravel uses the application's cache to remember which task hasn't finished running.

php artisan schedule:clear-cache

Why and how to clear views cache in Laravel

Blade directives are compiled and cached even in your local environment. Sometimes though, compiled views can conflict with a recent change in your code. Again, you have a command for that:

php artisan view:clear

How to clear every cache in Laravel

Finally, let's see the ultimate cache-busting command.

php artisan optimize:clear

This command will remove the following caches:

  • Config
  • Compiled classes cache
  • Events
  • General Cache
  • Routes
  • Views

How do I know that? Simple. I used the "Go To File" command in my code editor and searched for the "OptimizeClearCommand.php" file. Its source code is straightforward to understand, as you can see:

…

class OptimizeClearCommand extends Command
{
    …

    public function handle()
    {
        $this->components->info('Clearing cached bootstrap files.');

        collect([
            'events' => fn () => $this->callSilent('event:clear') == 0,
            'views' => fn () => $this->callSilent('view:clear') == 0,
            'cache' => fn () => $this->callSilent('cache:clear') == 0,
            'route' => fn () => $this->callSilent('route:clear') == 0,
            'config' => fn () => $this->callSilent('config:clear') == 0,
            'compiled' => fn () => $this->callSilent('clear-compiled') == 0,
        ])->each(fn ($task, $description) => $this->components->task($description, $task));

        $this->newLine();
    }
}
Last updated 3 weeks ago.
1
Like this article? Let the author know and give them a clap!
benjamincrozat (Benjamin Crozat) Full-stack Laravel developer passionate about the TALL stack. Big appetite for UI and UX design.

Other articles you might like

September 29th 2022

Freelancing as a Laravel Developer: One Year Later

Introduction As of the 27th September 2022, I've officially been freelancing full-time for an entire...

Read article
August 8th 2022

Why don't you start writing tests?

See how easy it is to get started with automated testing in Laravel There are hundreds of articles...

Read article
September 21st 2021

Using Database Transactions to Write Safer Laravel Code

Introduction In web development, data integrity and accuracy is really important. So, making sure th...

Read article

We'd like to thank these amazing companies for supporting us

Your logo here?

The Laravel portal for problem solving, knowledge sharing and community building.

© 2022 Laravel.io - All rights reserved.