Adding tryNew to all URI related classes which already have a new method

BaseUri.php

@@ -32,6 +32,7 @@
 use function explode;
 use function implode;
 use function in_array;
+use function is_bool;
 use function preg_match;
 use function rawurldecode;
 use function str_repeat;
@@ -361,6 +362,26 @@ public function relativize(Stringable|string $uri): static
         );
     }
 
+    /**
+     * Apply the callback if the given "condition" is (or resolves to) true.
+     *
+     * @param (callable($this): bool)|bool $condition
+     * @param callable($this): (self|null) $onSuccess
+     * @param ?callable($this): (self|null) $onFail
+     */
+    final public function when(callable|bool $condition, callable $onSuccess, ?callable $onFail = null): self
+    {
+        if (!is_bool($condition)) {
+            $condition = $condition($this);
+        }
+
+        return match (true) {
+            $condition => $onSuccess($this),
+            null !== $onFail => $onFail($this),
+            default => $this,
+        } ?? $this;
+    }
+
     final protected function computeOrigin(Psr7UriInterface|UriInterface $uri, ?string $nullValue): Psr7UriInterface|UriInterface|null
     {
         $scheme = $uri->getScheme();

CHANGELOG.md

@@ -9,6 +9,8 @@ All Notable changes to `League\Uri` will be documented in this file
 - `Http::when` conditional method to ease component building logic.
 - `Uri::when` conditional method to ease component building logic.
 - `BaseUri::when` conditional method to ease component building logic.
+- `Uri::tryNew` returns a new `Uri` instance on success or null on failure.
+- `Http::tryNew` returns a new `Uri` instance on success or null on failure.
 
 ### Fixed
 

Http.php

@@ -82,6 +82,18 @@ public static function new(Stringable|string $uri = ''): self
         return self::fromComponents(UriString::parse($uri));
     }
 
+    /**
+     * Create a new instance from a string.or a stringable structure or returns null on failure.
+     */
+    public static function tryNew(Stringable|string $uri = ''): ?self
+    {
+        try {
+            return self::new($uri);
+        } catch (UriException) {
+            return null;
+        }
+    }
+
     /**
      * Create a new instance from a hash of parse_url parts.
      *

Uri.php

@@ -379,6 +379,18 @@ private function formatPort(?int $port = null): ?int
         };
     }
 
+    /**
+     * Create a new instance from a string.or a stringable structure or returns null on failure.
+     */
+    public static function tryNew(Stringable|string $uri = ''): ?self
+    {
+        try {
+            return self::new($uri);
+        } catch (UriException) {
+            return null;
+        }
+    }
+
     /**
      * Create a new instance from a string.
      */