[12.x] Introducing toUri to the Stringable Class (#55862)

* Feat: Add Stringable toUri method

* Tests

Author: devajmeireles

src/Illuminate/Support/Stringable.php

@@ -1430,6 +1430,16 @@ public function toDate($format = null, $tz = null)
         return Date::createFromFormat($format, $this->value, $tz);
     }
 
+    /**
+     * Get the underlying string value as a Uri instance.
+     *
+     * @return \Illuminate\Support\Uri
+     */
+    public function toUri()
+    {
+        return Uri::of($this->value);
+    }
+
     /**
      * Convert the object to a string when JSON encoded.
      *

tests/Support/SupportStringableTest.php

@@ -6,6 +6,7 @@
 use Illuminate\Support\Collection;
 use Illuminate\Support\HtmlString;
 use Illuminate\Support\Stringable;
+use Illuminate\Support\Uri;
 use League\CommonMark\Environment\EnvironmentBuilderInterface;
 use League\CommonMark\Extension\ExtensionInterface;
 use PHPUnit\Framework\TestCase;
@@ -1397,6 +1398,17 @@ public function testToDateThrowsException()
         $this->stringable('not a date')->toDate();
     }
 
+    public function testToUri()
+    {
+        $sentence = 'Laravel is a PHP framework. You can access the docs in: {https://laravel.com/docs}';
+
+        $uri = $this->stringable($sentence)->between('{', '}')->toUri();
+
+        $this->assertInstanceOf(Uri::class, $uri);
+        $this->assertSame('https://laravel.com/docs', (string) $uri);
+        $this->assertSame('https://laravel.com/docs', $uri->toHtml());
+    }
+
     public function testArrayAccess()
     {
         $str = $this->stringable('my string');