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

thephpleague · Dec 21, 2024 · 6a2fb0a · 6a2fb0a
1 parent 08cfc6c
commit 6a2fb0a
Show file tree

Hide file tree

Showing 3 changed files with 7 additions and 0 deletions.
diff --git a/Contracts/UriAccess.php b/Contracts/UriAccess.php
@@ -15,6 +15,9 @@
 
 use Psr\Http\Message\UriInterface as Psr7UriInterface;
 
+/**
+ * @method self when(callable|bool $condition, callable $onSuccess, ?callable $onFail = null) conditionally return a new instance
+ */
 interface UriAccess
 {
     public function getUri(): UriInterface|Psr7UriInterface;

diff --git a/Contracts/UriComponentInterface.php b/Contracts/UriComponentInterface.php
@@ -16,6 +16,9 @@
 use JsonSerializable;
 use Stringable;
 
+/**
+ * @method static when(callable|bool $condition, callable $onSuccess, ?callable $onFail = null) conditionally return a new instance
+ */
 interface UriComponentInterface extends JsonSerializable, Stringable
 {
     /**

diff --git a/Contracts/UriInterface.php b/Contracts/UriInterface.php
@@ -25,6 +25,7 @@
  * @method string|null getUsername() returns the user component of the URI.
  * @method string|null getPassword() returns the scheme-specific information about how to gain authorization to access the resource.
  * @method array toComponents() returns an associative array containing all the URI components.
+ * @method self when(callable|bool $condition, callable $onSuccess, ?callable $onFail = null) conditionally return a new instance
  */
 interface UriInterface extends JsonSerializable, Stringable
 {