Adding UriAccess::getInternationalizedUriString method

CHANGELOG.md

@@ -7,6 +7,7 @@ All Notable changes to `League\Uri\Components` will be documented in this file
 ### Added
 
 - `UrlSearchParams::uniqueKeyCount`
+- `Modifier::getInternationalizedUriString`
 
 ### Fixed
 

Modifier.php

@@ -58,6 +58,24 @@ public function getUri(): Psr7UriInterface|UriInterface
         return $this->uri;
     }
 
+    public function getInternationalizedUriString(): string
+    {
+        $currentHost = $this->uri->getHost();
+        if (null === $currentHost || '' === $currentHost) {
+            return $this->getUriString();
+        }
+
+        $host = IdnConverter::toUnicode($currentHost)->domain();
+        if ($host === $currentHost) {
+            return $this->getUriString();
+        }
+
+        $components = $this->uri instanceof UriInterface ? $this->uri->getComponents() : UriString::parse($this->uri);
+        $components['host'] = $host;
+
+        return UriString::build($components);
+    }
+
     public function getUriString(): string
     {
         return $this->uri->__toString();

ModifierTest.php

@@ -15,12 +15,13 @@
 use League\Uri\Components\DataPath;
 use League\Uri\Exceptions\SyntaxError;
 use PHPUnit\Framework\Attributes\CoversClass;
+use PHPUnit\Framework\Attributes\DataProvider;
 use PHPUnit\Framework\Attributes\Group;
 use PHPUnit\Framework\TestCase;
 
 use const PHP_QUERY_RFC3986;
 
-#[CoversClass(UriModifier::class)] /** @phpstan-ignore-line */
+#[CoversClass(Modifier::class)]
 #[Group('host')]
 #[Group('resolution')]
 final class ModifierTest extends TestCase
@@ -829,4 +830,33 @@ public function testItCanSlicePathSegments(): void
 
         self::assertSame('http://www.localhost.com/the/sky/', Modifier::from($uri)->sliceSegments(2, 2)->getUriString());
     }
+
+    #[DataProvider('idnUriProvider')]
+    public function testItReturnsTheCorrectUriString(string $expected, string $input): void
+    {
+        self::assertSame($expected, Modifier::from($input)->getInternationalizedUriString());
+    }
+
+    public static function idnUriProvider(): iterable
+    {
+        yield 'basic uri stays the same' => [
+            'expected' => 'http://example.com/foo/bar',
+            'input' => 'http://example.com/foo/bar',
+        ];
+
+        yield 'idn host are changed' => [
+            'expected' => "http://bébé.be",
+            'input' => "http://xn--bb-bjab.be",
+        ];
+
+        yield 'idn host are the same' => [
+            'expected' => "http://bébé.be",
+            'input' => "http://bébé.be",
+        ];
+
+        yield 'the rest of the URI is not affected and uses RFC3986 rules' => [
+            'expected' => "http://bébé.be?q=toto%20le%20h%C3%A9ros",
+            'input' => "http://bébé.be:80?q=toto le héros",
+        ];
+    }
 }