Add variadic parameter $default to ViewInterface::getParameter()

CHANGELOG.md

@@ -5,6 +5,7 @@
 - Enh #269: Bump PHP version to `^8.1` and refactor code (@vjik)
 - Chg #271: Remove deprecated methods `withDefaultExtension()` and `getDefaultExtension()` from `ViewInterface` (@vjik)
 - Chg #271: Rename configuration parameter `defaultExtension` to `fallbackExtension` (@vjik)
+- Chg #272: Add variadic parameter `$default` to `ViewInterface::getParameter()` (@vjik)
 
 ## 10.0.0 June 28, 2024
 

UPGRADE.md

@@ -12,6 +12,7 @@ application when you upgrade the package from one version to another.
 - Removed `ViewInterface` methods `withDefaultExtension()` and `getDefaultExtension()`. Use `withFallbackExtension()`
   and `getFallbackExtensions()` instead, respectively. 
 - Rename configuration parameter `defaultExtension` to `fallbackExtension`.
+- Added variadic parameter `$default` to `ViewInterface::getParameter()`.
 
 ## Upgrade from 9.x
 

src/State/StateTrait.php

@@ -6,8 +6,6 @@
 
 use InvalidArgumentException;
 
-use function array_key_exists;
-use function func_get_args;
 use function is_array;
 
 /**
@@ -102,15 +100,14 @@ public function removeParameter(string $id): static
      *
      * @return mixed The value of the parameter.
      */
-    public function getParameter(string $id)
+    public function getParameter(string $id, mixed ...$default): mixed
     {
         if (isset($this->parameters[$id])) {
             return $this->parameters[$id];
         }
 
-        $args = func_get_args();
-        if (array_key_exists(1, $args)) {
-            return $args[1];
+        if (!empty($default)) {
+            return reset($default);
         }
 
         throw new InvalidArgumentException('Parameter "' . $id . '" not found.');

src/ViewInterface.php

@@ -169,7 +169,7 @@ public function removeParameter(string $id): static;
      *
      * @return mixed The value of the parameter.
      */
-    public function getParameter(string $id);
+    public function getParameter(string $id, mixed ...$default): mixed;
 
     /**
      * Checks the existence of a common parameter by ID.

src/ViewTrait.php

@@ -17,12 +17,11 @@
 use function array_merge;
 use function array_pop;
 use function basename;
-use function call_user_func_array;
+use function call_user_func;
 use function crc32;
 use function dechex;
 use function dirname;
 use function end;
-use function func_get_args;
 use function is_file;
 use function pathinfo;
 use function substr;
@@ -115,7 +114,7 @@
     public function withFallbackExtension(string $fallbackExtension, string ...$otherFallbacks): static
     {
         $new = clone $this;
         $new->fallbackExtensions = [$fallbackExtension, ...array_values($otherFallbacks)];
         return $new;
     }
 
@@ -304,9 +303,9 @@
      *
      * @return mixed The value of the parameter.
      */
-    public function getParameter(string $id)
+    public function getParameter(string $id, mixed ...$default): mixed
     {
-        return call_user_func_array([$this->state, 'getParameter'], func_get_args());
+        return call_user_func([$this->state, 'getParameter'], $id, ...$default);
     }
 
     /**
@@ -433,7 +432,7 @@
         }
 
         $output = '';
         $this->viewFiles[] = [
             'resolved' => $viewFile,
             'requested' => $requestedFile,
         ];