Adding missing PHP Uri interface methods

uri/CHANGELOG.md

@@ -32,6 +32,7 @@ All Notable changes to `League\Uri` will be documented in this file
 - `Uri::getUser` to be inline with PHP native URI interface
 - `Uri::withUser` to be inline with PHP native URI interface
 - `Uri::withPassword` to be inline with PHP native URI interface
+- `Uri::__serialize` and `Uri::__unserialize` methods
 
 ### Fixed
 

uri/Uri.php

@@ -265,7 +265,6 @@ private function __construct(
         $this->authority = UriString::buildAuthority($this->toComponents());
         $this->uri = UriString::buildUri($this->scheme, $this->authority, $this->path, $this->query, $this->fragment);
         $this->assertValidState();
-
         $this->origin = $this->setOrigin();
     }
 
@@ -1812,6 +1811,31 @@ private static function getSegments(string $path): array
         });
     }
 
+    public function __serialize(): array
+    {
+        return $this->toComponents();
+    }
+
+    /**
+     * @param ComponentMap $data
+     */
+    public function __unserialize(array $data): void
+    {
+        $this->scheme = $this->formatScheme($data['scheme'] ?? null);
+        $this->user = Encoder::encodeUser($data['user'] ?? null);
+        $this->pass = Encoder::encodePassword($data['pass'] ?? null);
+        $this->host = $this->formatHost($data['host'] ?? null);
+        $this->port = $this->formatPort($data['port'] ?? null);
+        $this->path = $this->formatPath($data['path'] ?? '');
+        $this->query = Encoder::encodeQueryOrFragment($data['query'] ?? null);
+        $this->fragment = Encoder::encodeQueryOrFragment($data['fragment'] ?? null);
+        $this->userInfo = $this->formatUserInfo($this->user, $this->pass);
+        $this->authority = UriString::buildAuthority($this->toComponents());
+        $this->uri = UriString::buildUri($this->scheme, $this->authority, $this->path, $this->query, $this->fragment);
+        $this->assertValidState();
+        $this->origin = $this->setOrigin();
+    }
+
     /**
      * DEPRECATION WARNING! This method will be removed in the next major point release.
      *

uri/UriTest.php

@@ -23,6 +23,9 @@
 use Psr\Http\Message\UriInterface as Psr7UriInterface;
 use TypeError;
 
+use function serialize;
+use function unserialize;
+
 #[CoversClass(Uri::class)]
 #[Group('uri')]
 class UriTest extends TestCase
@@ -1098,4 +1101,14 @@ public function it_requires_a_user_component_to_update_the_password_component():
 
         Uri::new('example://host/path?query')->withPassword('pass');
     }
+
+    #[Test]
+    public function it_can_be_serialized_by_php(): void
+    {
+        $uri = Uri::new('https://user:[email protected]:81/path?query#fragment');
+        /** @var Uri $newUri */
+        $newUri = unserialize(serialize($uri));
+
+        self::assertTrue($uri->equals($newUri, excludeFragment: false));
+    }
 }