feat: add trait UseStorage.

Author: fureev

CHANGELOG.md

@@ -9,6 +9,13 @@ The format is based on [Keep a Changelog][keepachangelog] and this project adher
 ### Added
 
 - Add `PHP 8.4` support
+- Add `UseStorage` trait. Trait `ArrayStorage` is deprecated now
+- Add `UseConfigurabeStorage` trait. Trait `ArrayStorageConfigurableTrait` is deprecated now
+
+### Removed
+
+- Remove Trait `ArrayStorage`. Use `UseStorage` instead
+- Remove Trait `ArrayStorageConfigurableTrait`. Use `UseConfigurabeStorage` instead
 
 ## v4.28.0
 

src/Enums/WithEnhances.php

@@ -5,6 +5,7 @@
 namespace Php\Support\Enums;
 
 /**
+ * @template TValue
  * @mixin \UnitEnum
  */
 trait WithEnhances
@@ -18,13 +19,16 @@ public static function casesToString(callable $decorator, string $delimiter = ',
     }
 
     /**
-     * @return mixed[]
+     * @return TValue[]
      */
     public static function values(): array
     {
         return array_map(static fn(self $enumItem) => $enumItem->value, self::cases());
     }
 
+    /**
+     * @return string[]
+     */
     public static function names(): array
     {
         return array_map(static fn(self $enumItem) => $enumItem->name, self::cases());
@@ -35,16 +39,22 @@ public static function hasName(string $value): bool
         return in_array($value, static::names(), true);
     }
 
+    /**
+     * @return array<string, TValue>
+     */
     public static function toKeyValueArray(): array
     {
         $list = [];
         foreach (self::cases() as $case) {
-            $list[$case->value] = $case->name;
+            $list[$case->name] = $case->value;
         }
 
         return $list;
     }
 
+    /**
+     * @return array<string, string>
+     */
     public static function toValueKeyArray(): array
     {
         $list = [];

src/Exceptions/ConfigException.php

@@ -6,27 +6,15 @@
 
 /**
  * Class ConfigException
- *
- * @package Php\Support\Exceptions
  */
 class ConfigException extends Exception
 {
     /**
-     * ConfigException constructor.
-     *
-     * @param ?array $config
      * @param string $message
+     * @param array<string, mixed> $config
      */
-    public function __construct(string $message = 'Config Exception', protected ?array $config = null)
+    public function __construct(string $message = 'Config Exception', protected(set) array $config = [])
     {
         parent::__construct($message);
     }
-
-    /**
-     * @return array|null
-     */
-    public function getConfig(): ?array
-    {
-        return $this->config;
-    }
 }

src/Exceptions/Exception.php

@@ -10,8 +10,6 @@
 
 /**
  * Class Exception
- *
- * @package Php\Support\Exceptions
  */
 class Exception extends \Exception
 {

src/Exceptions/InvalidArgumentException.php

@@ -8,18 +8,9 @@
 
 /**
  * Class InvalidArgumentException
- *
- * @package Php\Support\Exceptions
  */
 class InvalidArgumentException extends \InvalidArgumentException
 {
-    /**
-     * Exception constructor.
-     *
-     * @param ?string $message
-     * @param int $code
-     * @param ?Throwable $previous
-     */
     public function __construct(?string $message = null, int $code = 0, ?Throwable $previous = null)
     {
         parent::__construct($message ?? $this->getName(), $code, $previous);

src/Exceptions/InvalidCallException.php

@@ -8,13 +8,9 @@
 
 /**
  * Class InvalidCallException
- * @package Php\Support\Exceptions
  */
 class InvalidCallException extends BadMethodCallException
 {
-    /**
-     * @return string
-     */
     public function getName(): string
     {
         return 'Invalid Call';

src/Exceptions/InvalidConfigException.php

@@ -6,18 +6,10 @@
 
 /**
  * Class InvalidConfigException
- *
- * @package Php\Support\Exceptions
  */
 class InvalidConfigException extends ConfigException
 {
-    /**
-     * InvalidConfigException constructor.
-     *
-     * @param ?array $config
-     * @param string $message
-     */
-    public function __construct(?array $config = null, $message = 'Invalid Configuration')
+    public function __construct(array $config = [], string $message = 'Invalid Configuration')
     {
         parent::__construct($message, $config);
     }

src/Exceptions/InvalidParamException.php

@@ -6,41 +6,17 @@
 
 use LogicException;
 
-/**
- * Class InvalidParamException
- *
- * @package Php\Support\Exceptions
- */
 class InvalidParamException extends LogicException
 {
-    /** @var string|null */
-    protected $param;
-
-    /**
-     * InvalidParamException constructor.
-     *
-     * @param null|string $param
-     * @param null|string $message
-     */
-    public function __construct(?string $message = null, ?string $param = null)
+    public function __construct(?string $message = null, public private(set) readonly ?string $name = null)
     {
-        $this->param = $param;
-        parent::__construct($message ?? sprintf('Invalid Parameter' . ($this->param ? ': %s' : ''), $this->param));
+        parent::__construct(
+            $message ?? sprintf('Invalid Parameter' . ($this->name ? ': %s' : ''), $this->name)
+        );
     }
 
-    /**
-     * @return string
-     */
     public function getName(): string
     {
         return 'Invalid Parameter';
     }
-
-    /**
-     * @return null|string
-     */
-    public function getParam(): ?string
-    {
-        return $this->param;
-    }
 }

src/Exceptions/InvalidValueException.php

@@ -8,13 +8,9 @@
 
 /**
  * Class InvalidValueException
- * @package Php\Support\Exceptions
  */
 class InvalidValueException extends UnexpectedValueException
 {
-    /**
-     * @return string
-     */
     public function getName(): string
     {
         return 'Invalid Return Value';

src/Exceptions/MethodNotAllowedException.php

@@ -6,21 +6,10 @@
 
 /**
  * Class MethodNotAllowedException
- *
- * @package Php\Support\Exceptions
  */
 class MethodNotAllowedException extends Exception
 {
-    /** @var string */
-    protected $reason;
-
-    /**
-     * MethodNotAllowedException constructor.
-     *
-     * @param string $reason
-     * @param string $message
-     */
-    public function __construct(string $reason, $message = 'Method Not Allowed')
+    public function __construct(protected string $reason, string $message = 'Method Not Allowed')
     {
         $this->reason = $reason;