[12.x] Custom public path resolver for Vite assets

src/Illuminate/Foundation/Vite.php

@@ -83,6 +83,13 @@ class Vite implements Htmlable
      */
     protected $preloadTagAttributesResolvers = [];
 
+    /**
+     * The public path resolver.
+     *
+     * @var callable|null
+     */
+    protected $publicPathResolver = null;
+
     /**
      * The preloaded assets.
      *
@@ -215,6 +222,19 @@ public function createAssetPathsUsing($resolver)
         return $this;
     }
 
+    /**
+     * Resolve public paths using the provided resolver.
+     *
+     * @param  callable|null  $resolver
+     * @return $this
+     */
+    public function createPublicPathsUsing($resolver)
+    {
+        $this->publicPathResolver = $resolver;
+
+        return $this;
+    }
+
     /**
      * Get the Vite "hot" file path.
      *
@@ -897,7 +917,7 @@ public function content($asset, $buildDirectory = null)
 
         $chunk = $this->chunk($this->manifest($buildDirectory), $asset);
 
-        $path = public_path($buildDirectory.'/'.$chunk['file']);
+        $path = $this->publicPath($buildDirectory.'/'.$chunk['file']);
 
         if (! is_file($path) || ! file_exists($path)) {
             throw new ViteException("Unable to locate file from Vite manifest: {$path}.");
@@ -918,6 +938,17 @@ protected function assetPath($path, $secure = null)
         return ($this->assetPathResolver ?? asset(...))($path, $secure);
     }
 
+    /**
+     * Generate a public path for an asset.
+     *
+     * @param  string  $path
+     * @return string
+     */
+    protected function publicPath($path)
+    {
+        return ($this->publicPathResolver ?? public_path(...))($path);
+    }
+
     /**
      * Get the manifest file for the given build directory.
      *

tests/Foundation/FoundationViteTest.php

@@ -696,6 +696,35 @@ public function testViteCanAssetPath()
         $this->cleanViteManifest($buildDir);
     }
 
+    public function testViteCanResolvePublicPath()
+    {
+        $this->makeViteManifest([
+            'resources/style.css' => [
+                'src' => 'resources/style.css',
+                'file' => 'assets/style.css?v=version',
+            ],
+        ], $buildDir = Str::random());
+        $vite = app(Vite::class)->useBuildDirectory($buildDir);
+        $this->makeAsset('/style.css', 'some content', $buildDir);
+
+        // default behaviour: exception caused by appended version param
+        $this->assertThrows(fn () => $vite->content('resources/style.css'), ViteException::class);
+
+        // custom behaviour: works because we strip the version param
+        $vite->createPublicPathsUsing(fn ($path) => public_path(Str::before($path, '?')));
+
+        $this->assertDoesntThrow(fn () => $vite->content('resources/style.css'));
+        $this->assertSame('some content', $vite->content('resources/style.css'));
+
+        // restore default behaviour...
+        $vite->createPublicPathsUsing(null);
+
+        $this->assertThrows(fn () => $vite->content('resources/style.css'), ViteException::class);
+
+        $this->cleanAsset('/style.css', $buildDir);
+        $this->cleanViteManifest($buildDir);
+    }
+
     public function testViteIsMacroable()
     {
         $this->makeViteManifest([
@@ -1733,9 +1762,9 @@ protected function cleanViteManifest($path = 'build')
         }
     }
 
-    protected function makeAsset($asset, $content)
+    protected function makeAsset($asset, $content, $buildDir = 'build')
     {
-        $path = public_path('build/assets');
+        $path = public_path($buildDir.'/assets');
 
         if (! file_exists($path)) {
             mkdir($path, recursive: true);
@@ -1744,9 +1773,9 @@ protected function makeAsset($asset, $content)
         file_put_contents($path.'/'.$asset, $content);
     }
 
-    protected function cleanAsset($asset)
+    protected function cleanAsset($asset, $buildDir = 'build')
     {
-        $path = public_path('build/assets');
+        $path = public_path($buildDir.'/assets');
 
         unlink($path.$asset);