Add new method Url::toPsr7()

To conveniently convert a `Url` instance into a PSR-7 compatible one.

CHANGELOG.md

@@ -7,6 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.1.0] - 2023-10-21
+### Added
+- Method `toPsr7()` to conveniently get a PSR-7 compatible instance from an `Url` instance. Basically wrapper for `new Uri($urlInstance)`.
+
 ## [2.0.5] - 2023-09-19
 ### Fixed
 - Issue with resolving relative URLs.

src/Url.php

@@ -8,6 +8,7 @@
 use Crwlr\Url\Psr\Uri;
 use Exception;
 use InvalidArgumentException;
+use Psr\Http\Message\UriInterface;
 
 /**
  * Class Url
@@ -728,6 +729,11 @@ public function toString(): string
         return $this->url;
     }
 
+    public function toPsr7(): UriInterface
+    {
+        return new Uri($this);
+    }
+
     /**
      * Populate the URL components from an array or another instance of this class
      *

tests/UrlTest.php

@@ -4,6 +4,7 @@
 use Crwlr\Url\Exceptions\InvalidUrlException;
 use Crwlr\Url\Psr\Uri;
 use Crwlr\Url\Url;
+use Psr\Http\Message\UriInterface;
 
 /** @var \PHPUnit\Framework\TestCase $this */
 
@@ -948,6 +949,16 @@
     );
 });
 
+it('converts an Url instance into a PSR-7 compatible instance', function () {
+    $url = Url::parse('https://www.crwl.io/en/home');
+
+    expect($url)
+        ->not()
+        ->toBeInstanceOf(UriInterface::class)
+        ->and($url->toPsr7())
+        ->toBeInstanceOf(UriInterface::class);
+});
+
 function createDefaultUrlObject(): Url
 {
     return new Url('https://user:password@sub.sub.example.com:8080/some/path?some=query#fragment');