[11.x] Add a setAssetRoot method to the UrlGenerator class (#54530)

* Add a setAssetUrl method to the UrlGenerator class

* Change the method name to setAssetRoot to match property

* formatting

* fix

---------

Co-authored-by: Taylor Otwell <[email protected]>

Author: ollieread

src/Illuminate/Routing/UrlGenerator.php

@@ -742,11 +742,24 @@ public function forceHttps($force = true)
         }
     }
 
+    /**
+     * Set the URL origin for all generated URLs.
+     *
+     * @param  string|null  $root
+     * @return void
+     */
+    public function useOrigin(?string $root)
+    {
+        $this->forceRootUrl($root);
+    }
+
     /**
      * Set the forced root URL.
      *
      * @param  string|null  $root
      * @return void
+     *
+     * @deprecated Use useOrigin
      */
     public function forceRootUrl($root)
     {
@@ -755,6 +768,17 @@ public function forceRootUrl($root)
         $this->cachedRoot = null;
     }
 
+    /**
+     * Set the URL origin for all generated asset URLs.
+     *
+     * @param  string|null  $root
+     * @return void
+     */
+    public function useAssetOrigin(?string $root)
+    {
+        $this->assetRoot = $root ? rtrim($root, '/') : null;
+    }
+
     /**
      * Set a callback to be used to format the host of generated URLs.
      *

tests/Routing/RoutingUrlGeneratorTest.php

@@ -684,18 +684,36 @@ public function testUrlGenerationThrowsExceptionForMissingParametersWithMeaningf
         $url->route('foo', $parameters);
     }
 
-    public function testForceRootUrl()
+    public function testSetAssetUrl()
     {
         $url = new UrlGenerator(
             $routes = new RouteCollection,
             Request::create('http://www.foo.com/')
         );
 
-        $url->forceRootUrl('https://www.bar.com');
+        $url->useOrigin('https://www.bar.com');
+        $this->assertSame('http://www.bar.com/foo/bar', $url->to('foo/bar'));
+        $this->assertSame('http://www.bar.com/foo/bar', $url->asset('foo/bar'));
+
+        $url->useAssetOrigin('https://www.foo.com');
+        $this->assertNotSame('https://www.foo.com/foo/bar', $url->to('foo/bar'));
+        $this->assertSame('https://www.foo.com/foo/bar', $url->asset('foo/bar'));
+        $this->assertSame('https://www.foo.com/foo/bar', $url->asset('foo/bar', true));
+        $this->assertSame('https://www.foo.com/foo/bar', $url->asset('foo/bar', false));
+    }
+
+    public function testUseRootUrl()
+    {
+        $url = new UrlGenerator(
+            $routes = new RouteCollection,
+            Request::create('http://www.foo.com/')
+        );
+
+        $url->useOrigin('https://www.bar.com');
         $this->assertSame('http://www.bar.com/foo/bar', $url->to('foo/bar'));
 
         // Ensure trailing slash is trimmed from root URL as UrlGenerator already handles this
-        $url->forceRootUrl('http://www.foo.com/');
+        $url->useOrigin('http://www.foo.com/');
         $this->assertSame('http://www.foo.com/bar', $url->to('/bar'));
 
         /*
@@ -712,7 +730,7 @@ public function testForceRootUrl()
 
         $this->assertSame('https://www.foo.com/foo', $url->route('plain'));
 
-        $url->forceRootUrl('https://www.bar.com');
+        $url->useOrigin('https://www.bar.com');
         $this->assertSame('https://www.bar.com/foo', $url->route('plain'));
     }