Implementing the WhatWgUrl

Author: nyamsprod

.github/workflows/build.yml

@@ -7,7 +7,7 @@ on:
 jobs:
     linux_tests:
         name: PHP on ${{ matrix.php }} - ${{ matrix.stability }} - ${{ matrix.composer-flags }}
-        runs-on: ubuntu-20.04
+        runs-on: ubuntu-22.04
         strategy:
             matrix:
                 php: ['8.1', '8.2', '8.3', '8.4']

README.md

@@ -1,8 +1,16 @@
-# A polyfill for ongoing PHP RFC 3986 URI parsing support
+# A polyfill for ongoing PHP RFCFC 3986 and WHATWG compliant URI parsing support
 
-This is a PHP polyfill for RFC 3986 compliant URI parsing support based on the
-ongoing [RFC](https://wiki.php.net/rfc/url_parsing_api)
+This is a PHP polyfill for the ongoing [RFC](https://wiki.php.net/rfc/url_parsing_api) to add support for
 
-The polyfill uses [League URI Interface Package](https://github.com/thephpleague/uri-interfaces)
+- an RFC 3986 compliant URI parsing 
+- an WHATWG compliant URI parsing
+
+The polyfills use:
+
+- [League URI Interface Package](https://github.com/thephpleague/uri-interfaces)
+- [URL-Parser](https://github.com/TRowbotham/URL-Parser)
 
 Please view the RFC document to understand the URI instance public API.
+
+> [!WARNING]
+> **The implementations are made to be correct not to be fast**

composer.json

@@ -22,7 +22,8 @@
     },
     "require": {
         "php": "^8.1",
-        "league/uri-interfaces": "dev-master"
+        "league/uri-interfaces": "dev-master",
+        "rowbot/url": "^4.0"
     },
     "require-dev": {
         "friendsofphp/php-cs-fixer": "^3.68.5",

phpstan.neon

@@ -6,6 +6,7 @@ includes:
 parameters:
     ignoreErrors:
         - '#Comparison operation "<" between int<80100, 80499> and 80500 is always true.#'
+        - '#Dead catch - Exception is never thrown in the try block.#'
     level: max
     paths:
         - src

src/WhatWg/InvalidUrlException.php

@@ -0,0 +1,36 @@
+<?php
+
+/**
+ * Aide.Uri (https://https://github.com/bakame-php/aide-uri)
+ *
+ * (c) Ignace Nyamagana Butera <nyamsprod@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+declare(strict_types=1);
+
+namespace Uri\WhatWg;
+
+use Exception;
+use Uri\InvalidUriException;
+
+use const PHP_VERSION_ID;
+
+if (PHP_VERSION_ID < 80500) {
+    class InvalidUrlException extends InvalidUriException
+    {
+        /**
+         * @param array<int, UrlValidationError> $errors
+         */
+        public function __construct(
+            string $message,
+            public readonly array $errors = [],
+            int $code = 0,
+            ?Exception $previous = null
+        ) {
+            parent::__construct($message, $code, $previous);
+        }
+    }
+}