Add URL::getRelative method

Author: natanfelles

src/URL.php

@@ -284,16 +284,29 @@ public function getUrl() : string
             $url .= '@';
         }
         $url .= $this->getHost();
-        $url .= $this->getPath();
+        $url .= $this->getRelative();
+        return $url;
+    }
+
+    /**
+     * Get the relative URL.
+     *
+     * @since 6.1
+     *
+     * @return string
+     */
+    public function getRelative() : string
+    {
+        $relative = $this->getPath();
         $part = $this->getQuery();
         if ($part !== null) {
-            $url .= '?' . $part;
+            $relative .= '?' . $part;
         }
         $part = $this->getFragment();
         if ($part !== null) {
-            $url .= '#' . $part;
+            $relative .= '#' . $part;
         }
-        return $url;
+        return $relative;
     }
 
     /**

tests/URLTest.php

@@ -65,6 +65,34 @@ public function testSameUrl() : void
         self::assertSame($expected, $url->__toString());
     }
 
+    public function testRelative() : void
+    {
+        $url = 'http://domain.tld';
+        $object = new URL($url);
+        self::assertNotSame('', $object->getRelative());
+        $url = 'http://domain.tld/';
+        $object = new URL($url);
+        self::assertSame('/', $object->getRelative());
+        $url = 'http://domain.tld?foo=bar';
+        $object = new URL($url);
+        self::assertSame('/?foo=bar', $object->getRelative());
+        $url = 'http://domain.tld/?foo=bar';
+        $object = new URL($url);
+        self::assertSame('/?foo=bar', $object->getRelative());
+        $url = 'http://domain.tld#contact';
+        $object = new URL($url);
+        self::assertSame('/#contact', $object->getRelative());
+        $url = 'http://domain.tld/?foo=bar#contact';
+        $object = new URL($url);
+        self::assertSame('/?foo=bar#contact', $object->getRelative());
+        $url = 'http://domain.tld/foo/bar#contact';
+        $object = new URL($url);
+        self::assertSame('/foo/bar#contact', $object->getRelative());
+        $url = 'http://domain.tld/foo/bar/#contact';
+        $object = new URL($url);
+        self::assertSame('/foo/bar/#contact', $object->getRelative());
+    }
+
     public function testPathEndsWithBar() : void
     {
         $url = 'http://domain.tld';