Add config option to ignore view cache timestamps

laravel · taylorotwell · Apr 24, 2025 · Apr 24, 2025 · Apr 24, 2025 · Apr 24, 2025
commit 191271aa170919aa320fce14376055601d32276a
diff --git a/config/view.php b/config/view.php
@@ -33,4 +33,21 @@
         realpath(storage_path('framework/views'))
     ),
 
+    /*
+    |--------------------------------------------------------------------------
+    | Ignore view cache timestamps
+    |--------------------------------------------------------------------------
+    |
+    | This option determines whether timestamps of cached views should be
+    | ignored. You should only enable this if you have pre-compiled all views
+    | with `artisan view:cache`. Whenever a view templates changes, you must
+    | run this command again to update the view cache.
+    |
+    */
+
+    'ignore_cache_timestamps' => env(
+        'VIEW_CACHE_IGNORE_TIMESTAMPS',
+        false
+    ),
+
 ];
diff --git a/src/Illuminate/View/Compilers/Compiler.php b/src/Illuminate/View/Compilers/Compiler.php
@@ -42,7 +42,14 @@ abstract class Compiler
      *
      * @var string
      */
-    protected $compiledExtension = 'php';
+    protected $compiledExtension;
+
+    /**
+     * Determines if view cache timestamps should be ignored.
+     *
+     * @var bool
+     */
+    protected $ignoreCacheTimestamps;
 
     /**
      * Create a new compiler instance.
@@ -61,6 +68,7 @@ public function __construct(
         $basePath = '',
         $shouldCache = true,
         $compiledExtension = 'php',
+        $ignoreCacheTimestamps = false,
     ) {
         if (! $cachePath) {
             throw new InvalidArgumentException('Please provide a valid cache path.');
@@ -71,6 +79,7 @@ public function __construct(
         $this->basePath = $basePath;
         $this->shouldCache = $shouldCache;
         $this->compiledExtension = $compiledExtension;
+        $this->ignoreCacheTimestamps = $ignoreCacheTimestamps;
     }
 
     /**
@@ -94,6 +103,10 @@ public function getCompiledPath($path)
      */
     public function isExpired($path)
     {
+        if ($this->ignoreCacheTimestamps) {
+            return false;
+        }
+
         if (! $this->shouldCache) {
             return true;
         }

diff --git a/src/Illuminate/View/ViewServiceProvider.php b/src/Illuminate/View/ViewServiceProvider.php
@@ -100,6 +100,7 @@ public function registerBladeCompiler()
                 $app['config']->get('view.relative_hash', false) ? $app->basePath() : '',
                 $app['config']->get('view.cache', true),
                 $app['config']->get('view.compiled_extension', 'php'),
+                $app['config']->get('view.ignore_cache_timestamps', false),
             ), function ($blade) {
                 $blade->component('dynamic-component', DynamicComponent::class);
             });

diff --git a/tests/View/ViewBladeCompilerTest.php b/tests/View/ViewBladeCompilerTest.php
@@ -55,6 +55,12 @@ public function testIsExpiredReturnsTrueWhenUseCacheIsFalse()
         $this->assertTrue($compiler->isExpired('foo'));
     }
 
+    public function testIsExpiredReturnsFalseWhenIgnoreCacheTimestampsIsTrue()
+    {
+        $compiler = new BladeCompiler($this->getFiles(), __DIR__, ignoreCacheTimestamps: true);
+        $this->assertFalse($compiler->isExpired('foo'));
+    }
+
     public function testCompilePathIsProperlyCreated()
     {
         $compiler = new BladeCompiler($this->getFiles(), __DIR__);