first commit

system/Entity/Exceptions/CastException.php

@@ -0,0 +1,75 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * This file is part of CodeIgniter 4 framework.
+ *
+ * (c) CodeIgniter Foundation <admin@codeigniter.com>
+ *
+ * For the full copyright and license information, please view
+ * the LICENSE file that was distributed with this source code.
+ */
+
+namespace CodeIgniter\Entity\Exceptions;
+
+use CodeIgniter\Exceptions\FrameworkException;
+use CodeIgniter\Exceptions\HasExitCodeInterface;
+
+/**
+ * CastException is thrown for invalid cast initialization and management.
+ */
+class CastException extends FrameworkException implements HasExitCodeInterface
+{
+    public function getExitCode(): int
+    {
+        return EXIT_CONFIG;
+    }
+
+    /**
+     * Thrown when the cast class does not extends BaseCast.
+     *
+     * @return static
+     */
+    public static function forInvalidInterface(string $class)
+    {
+        return new static(lang('Cast.baseCastMissing', [$class]));
+    }
+
+    /**
+     * Thrown when the Json format is invalid.
+     *
+     * @return static
+     */
+    public static function forInvalidJsonFormat(int $error)
+    {
+        return match ($error) {
+            JSON_ERROR_DEPTH          => new static(lang('Cast.jsonErrorDepth')),
+            JSON_ERROR_STATE_MISMATCH => new static(lang('Cast.jsonErrorStateMismatch')),
+            JSON_ERROR_CTRL_CHAR      => new static(lang('Cast.jsonErrorCtrlChar')),
+            JSON_ERROR_SYNTAX         => new static(lang('Cast.jsonErrorSyntax')),
+            JSON_ERROR_UTF8           => new static(lang('Cast.jsonErrorUtf8')),
+            default                   => new static(lang('Cast.jsonErrorUnknown')),
+        };
+    }
+
+    /**
+     * Thrown when the cast method is not `get` or `set`.
+     *
+     * @return static
+     */
+    public static function forInvalidMethod(string $method)
+    {
+        return new static(lang('Cast.invalidCastMethod', [$method]));
+    }
+
+    /**
+     * Thrown when the casting timestamp is not correct timestamp.
+     *
+     * @return static
+     */
+    public static function forInvalidTimestamp()
+    {
+        return new static(lang('Cast.invalidTimestamp'));
+    }
+}