From 70ec8e340eaa53015e958ba1c91e825ae79cca7d Mon Sep 17 00:00:00 2001
From: "Bruno O. Notario" <bruno@exacti.com.br>
Date: Sun, 22 Oct 2023 17:29:58 -0300
Subject: [PATCH] Renamed case for Exception folder

---
 system/Exception/BadFunctionCallException.php | 19 +++++
 system/Exception/BadMethodCallException.php   | 19 +++++
 system/Exception/DomainException.php          | 19 +++++
 system/Exception/InvalidArgumentException.php | 18 +++++
 system/Exception/LengthException.php          | 19 +++++
 system/Exception/LogicException.php           | 18 +++++
 system/Exception/OutOfBoundsException.php     | 19 +++++
 system/Exception/OutOfRangeException.php      | 19 +++++
 system/Exception/OverflowException.php        | 19 +++++
 system/Exception/RESTException.php            | 18 +++++
 system/Exception/RangeException.php           | 19 +++++
 system/Exception/RuntimeException.php         | 18 +++++
 system/Exception/Throwable.php                | 36 +++++++++
 system/Exception/UnderflowException.php       | 19 +++++
 system/Exception/UnexpectedValueException.php | 19 +++++
 system/Exception/WebApiException.php          | 53 ++++++++++++
 system/arrayClass/Aux/LegacyAux.php           | 79 ++++++++++++++++++
 system/arrayClass/Aux/ModernAux.php           | 80 +++++++++++++++++++
 system/arrayClass/CaseInsensitiveArray.php    | 38 +++++++++
 19 files changed, 548 insertions(+)
 create mode 100644 system/Exception/BadFunctionCallException.php
 create mode 100644 system/Exception/BadMethodCallException.php
 create mode 100644 system/Exception/DomainException.php
 create mode 100644 system/Exception/InvalidArgumentException.php
 create mode 100644 system/Exception/LengthException.php
 create mode 100644 system/Exception/LogicException.php
 create mode 100644 system/Exception/OutOfBoundsException.php
 create mode 100644 system/Exception/OutOfRangeException.php
 create mode 100644 system/Exception/OverflowException.php
 create mode 100644 system/Exception/RESTException.php
 create mode 100644 system/Exception/RangeException.php
 create mode 100644 system/Exception/RuntimeException.php
 create mode 100644 system/Exception/Throwable.php
 create mode 100644 system/Exception/UnderflowException.php
 create mode 100644 system/Exception/UnexpectedValueException.php
 create mode 100644 system/Exception/WebApiException.php
 create mode 100644 system/arrayClass/Aux/LegacyAux.php
 create mode 100644 system/arrayClass/Aux/ModernAux.php
 create mode 100644 system/arrayClass/CaseInsensitiveArray.php

diff --git a/system/Exception/BadFunctionCallException.php b/system/Exception/BadFunctionCallException.php
new file mode 100644
index 0000000..40dc997
--- /dev/null
+++ b/system/Exception/BadFunctionCallException.php
@@ -0,0 +1,19 @@
+<?php
+/**
+ * Copyright © 2023 ExacTI Technology Solutions. All rights reserved.
+ * GPLv3 General License.
+ * https://exacti.com.br
+ * Phacil PHP Framework - https://github.com/exacti/phacil-framework
+ */
+
+
+namespace Phacil\Framework\Exception;
+
+/**
+ * Exception thrown if a callback refers to an undefined function or if some arguments are missing.
+ * 
+ * @package Phacil\Framework\Exception
+ */
+class BadFunctionCallException extends \Phacil\Framework\Exception\LogicException {
+
+}
\ No newline at end of file
diff --git a/system/Exception/BadMethodCallException.php b/system/Exception/BadMethodCallException.php
new file mode 100644
index 0000000..84af70e
--- /dev/null
+++ b/system/Exception/BadMethodCallException.php
@@ -0,0 +1,19 @@
+<?php
+/**
+ * Copyright © 2023 ExacTI Technology Solutions. All rights reserved.
+ * GPLv3 General License.
+ * https://exacti.com.br
+ * Phacil PHP Framework - https://github.com/exacti/phacil-framework
+ */
+
+
+namespace Phacil\Framework\Exception;
+
+/**
+ * Exception thrown if a callback refers to an undefined method or if some arguments are missing.
+ * 
+ * @package Phacil\Framework\Exception
+ */
+class BadMethodCallException extends \Phacil\Framework\Exception\BadFunctionCallException {
+
+}
\ No newline at end of file
diff --git a/system/Exception/DomainException.php b/system/Exception/DomainException.php
new file mode 100644
index 0000000..b981d96
--- /dev/null
+++ b/system/Exception/DomainException.php
@@ -0,0 +1,19 @@
+<?php
+/**
+ * Copyright © 2023 ExacTI Technology Solutions. All rights reserved.
+ * GPLv3 General License.
+ * https://exacti.com.br
+ * Phacil PHP Framework - https://github.com/exacti/phacil-framework
+ */
+
+
+namespace Phacil\Framework\Exception;
+
+/**
+ * Exception thrown if a value does not adhere to a defined valid data domain.
+ * 
+ * @package Phacil\Framework\Exception
+ */
+class DomainException extends \Phacil\Framework\Exception\LogicException {
+
+}
\ No newline at end of file
diff --git a/system/Exception/InvalidArgumentException.php b/system/Exception/InvalidArgumentException.php
new file mode 100644
index 0000000..4188439
--- /dev/null
+++ b/system/Exception/InvalidArgumentException.php
@@ -0,0 +1,18 @@
+<?php
+/**
+ * Copyright © 2023 ExacTI Technology Solutions. All rights reserved.
+ * GPLv3 General License.
+ * https://exacti.com.br
+ * Phacil PHP Framework - https://github.com/exacti/phacil-framework
+ */
+
+
+namespace Phacil\Framework\Exception;
+
+/**
+ * Exception thrown if an argument is not of the expected type.
+ * @package Phacil\Framework\Exception
+ */
+class InvalidArgumentException extends \Phacil\Framework\Exception\LogicException {
+
+}
\ No newline at end of file
diff --git a/system/Exception/LengthException.php b/system/Exception/LengthException.php
new file mode 100644
index 0000000..79fd0da
--- /dev/null
+++ b/system/Exception/LengthException.php
@@ -0,0 +1,19 @@
+<?php
+/**
+ * Copyright © 2023 ExacTI Technology Solutions. All rights reserved.
+ * GPLv3 General License.
+ * https://exacti.com.br
+ * Phacil PHP Framework - https://github.com/exacti/phacil-framework
+ */
+
+
+namespace Phacil\Framework\Exception;
+
+/**
+ * Exception thrown if a length is invalid.
+ * 
+ * @package Phacil\Framework\Exception
+ */
+class LengthException extends \Phacil\Framework\Exception\LogicException {
+
+}
\ No newline at end of file
diff --git a/system/Exception/LogicException.php b/system/Exception/LogicException.php
new file mode 100644
index 0000000..156a7c7
--- /dev/null
+++ b/system/Exception/LogicException.php
@@ -0,0 +1,18 @@
+<?php
+/**
+ * Copyright © 2023 ExacTI Technology Solutions. All rights reserved.
+ * GPLv3 General License.
+ * https://exacti.com.br
+ * Phacil PHP Framework - https://github.com/exacti/phacil-framework
+ */
+
+namespace Phacil\Framework\Exception;
+
+/**
+ * Exception that represents error in the program logic. This kind of exception should lead directly to a fix in your code.
+ * 
+ * @package Phacil\Framework\Exception
+ */
+class LogicException extends \Phacil\Framework\Exception {
+
+}
\ No newline at end of file
diff --git a/system/Exception/OutOfBoundsException.php b/system/Exception/OutOfBoundsException.php
new file mode 100644
index 0000000..203bf68
--- /dev/null
+++ b/system/Exception/OutOfBoundsException.php
@@ -0,0 +1,19 @@
+<?php
+/**
+ * Copyright © 2023 ExacTI Technology Solutions. All rights reserved.
+ * GPLv3 General License.
+ * https://exacti.com.br
+ * Phacil PHP Framework - https://github.com/exacti/phacil-framework
+ */
+
+
+namespace Phacil\Framework\Exception;
+
+/**
+ * Exception thrown if a value is not a valid key. This represents errors that cannot be detected at compile time.
+ * 
+ * @package Phacil\Framework\Exception
+ */
+class OutOfBoundsException extends \Phacil\Framework\Exception\RuntimeException {
+
+}
\ No newline at end of file
diff --git a/system/Exception/OutOfRangeException.php b/system/Exception/OutOfRangeException.php
new file mode 100644
index 0000000..41f96c1
--- /dev/null
+++ b/system/Exception/OutOfRangeException.php
@@ -0,0 +1,19 @@
+<?php
+/**
+ * Copyright © 2023 ExacTI Technology Solutions. All rights reserved.
+ * GPLv3 General License.
+ * https://exacti.com.br
+ * Phacil PHP Framework - https://github.com/exacti/phacil-framework
+ */
+
+
+namespace Phacil\Framework\Exception;
+
+/**
+ * Exception thrown when an illegal index was requested. This represents errors that should be detected at compile time.
+ * 
+ * @package Phacil\Framework\Exception
+ */
+class OutOfRangeException extends \Phacil\Framework\Exception\LogicException {
+
+}
\ No newline at end of file
diff --git a/system/Exception/OverflowException.php b/system/Exception/OverflowException.php
new file mode 100644
index 0000000..d103e71
--- /dev/null
+++ b/system/Exception/OverflowException.php
@@ -0,0 +1,19 @@
+<?php
+/**
+ * Copyright © 2023 ExacTI Technology Solutions. All rights reserved.
+ * GPLv3 General License.
+ * https://exacti.com.br
+ * Phacil PHP Framework - https://github.com/exacti/phacil-framework
+ */
+
+
+namespace Phacil\Framework\Exception;
+
+/**
+ * Exception thrown when adding an element to a full container.
+ * 
+ * @package Phacil\Framework\Exception
+ */
+class OverflowException extends \Phacil\Framework\Exception\RuntimeException {
+
+}
\ No newline at end of file
diff --git a/system/Exception/RESTException.php b/system/Exception/RESTException.php
new file mode 100644
index 0000000..5477062
--- /dev/null
+++ b/system/Exception/RESTException.php
@@ -0,0 +1,18 @@
+<?php
+/**
+ * Copyright © 2023 ExacTI Technology Solutions. All rights reserved.
+ * GPLv3 General License.
+ * https://exacti.com.br
+ * Phacil PHP Framework - https://github.com/exacti/phacil-framework
+ */
+
+
+namespace Phacil\Framework\Exception;
+
+/**
+ * Exception for Rest API.
+ * @package Phacil\Framework\Exception
+ */
+class RESTException extends \Phacil\Framework\Exception\WebApiException {
+
+}
\ No newline at end of file
diff --git a/system/Exception/RangeException.php b/system/Exception/RangeException.php
new file mode 100644
index 0000000..c964e31
--- /dev/null
+++ b/system/Exception/RangeException.php
@@ -0,0 +1,19 @@
+<?php
+/**
+ * Copyright © 2023 ExacTI Technology Solutions. All rights reserved.
+ * GPLv3 General License.
+ * https://exacti.com.br
+ * Phacil PHP Framework - https://github.com/exacti/phacil-framework
+ */
+
+
+namespace Phacil\Framework\Exception;
+
+/**
+ * Exception thrown to indicate range errors during program execution. Normally this means there was an arithmetic error other than under/overflow. This is the runtime version of \Phacil\Framework\Exception\DomainException.
+ * 
+ * @package Phacil\Framework\Exception
+ */
+class RangeException extends \Phacil\Framework\Exception\RuntimeException {
+
+}
\ No newline at end of file
diff --git a/system/Exception/RuntimeException.php b/system/Exception/RuntimeException.php
new file mode 100644
index 0000000..f826d4e
--- /dev/null
+++ b/system/Exception/RuntimeException.php
@@ -0,0 +1,18 @@
+<?php
+/**
+ * Copyright © 2023 ExacTI Technology Solutions. All rights reserved.
+ * GPLv3 General License.
+ * https://exacti.com.br
+ * Phacil PHP Framework - https://github.com/exacti/phacil-framework
+ */
+
+namespace Phacil\Framework\Exception;
+
+/**
+ * Exception thrown if an error which can only be found on runtime occurs.
+ * 
+ * @package Phacil\Framework\Exception
+ */
+class RuntimeException extends \Phacil\Framework\Exception
+{
+}
diff --git a/system/Exception/Throwable.php b/system/Exception/Throwable.php
new file mode 100644
index 0000000..41de2a9
--- /dev/null
+++ b/system/Exception/Throwable.php
@@ -0,0 +1,36 @@
+<?php
+/**
+ * Copyright © 2023 ExacTI Technology Solutions. All rights reserved.
+ * GPLv3 General License.
+ * https://exacti.com.br
+ * Phacil PHP Framework - https://github.com/exacti/phacil-framework
+ */
+
+namespace Phacil\Framework\Exception;
+
+if (interface_exists('Throwable')) {
+	interface ThrowableBase extends \Throwable {}
+} else {
+	interface ThrowableBase{
+		public function getMessage();
+		public function getCode();
+		public function getFile();
+		public function getLine();
+		public function getTrace();
+		public function getTraceAsString();
+		public function getPrevious();
+		public function __toString();
+	}
+}
+
+/**
+ * Throwable is the base interface for any object that can be thrown via a throw statement, including Error and Exception.
+ * 
+ * Note: PHP classes cannot implement the \Throwable interface directly, and must instead extend \Exception. You can implement this interface on any class.
+ * 
+ * @package Phacil\Framework\Exception
+ */
+interface Throwable extends ThrowableBase {
+
+}
+
diff --git a/system/Exception/UnderflowException.php b/system/Exception/UnderflowException.php
new file mode 100644
index 0000000..f8061f7
--- /dev/null
+++ b/system/Exception/UnderflowException.php
@@ -0,0 +1,19 @@
+<?php
+/**
+ * Copyright © 2023 ExacTI Technology Solutions. All rights reserved.
+ * GPLv3 General License.
+ * https://exacti.com.br
+ * Phacil PHP Framework - https://github.com/exacti/phacil-framework
+ */
+
+
+namespace Phacil\Framework\Exception;
+
+/**
+ * Exception thrown when performing an invalid operation on an empty container, such as removing an element.
+ * 
+ * @package Phacil\Framework\Exception
+ */
+class UnderflowException extends \Phacil\Framework\Exception\RuntimeException {
+
+}
\ No newline at end of file
diff --git a/system/Exception/UnexpectedValueException.php b/system/Exception/UnexpectedValueException.php
new file mode 100644
index 0000000..4812101
--- /dev/null
+++ b/system/Exception/UnexpectedValueException.php
@@ -0,0 +1,19 @@
+<?php
+/**
+ * Copyright © 2023 ExacTI Technology Solutions. All rights reserved.
+ * GPLv3 General License.
+ * https://exacti.com.br
+ * Phacil PHP Framework - https://github.com/exacti/phacil-framework
+ */
+
+
+namespace Phacil\Framework\Exception;
+
+/**
+ * Exception thrown if a value does not match with a set of values. Typically this happens when a function calls another function and expects the return value to be of a certain type or value not including arithmetic or buffer related errors.
+ * 
+ * @package Phacil\Framework\Exception
+ */
+class UnexpectedValueException extends \Phacil\Framework\Exception\RuntimeException {
+
+}
\ No newline at end of file
diff --git a/system/Exception/WebApiException.php b/system/Exception/WebApiException.php
new file mode 100644
index 0000000..5601bbd
--- /dev/null
+++ b/system/Exception/WebApiException.php
@@ -0,0 +1,53 @@
+<?php
+/**
+ * Copyright © 2023 ExacTI Technology Solutions. All rights reserved.
+ * GPLv3 General License.
+ * https://exacti.com.br
+ * Phacil PHP Framework - https://github.com/exacti/phacil-framework
+ */
+
+
+namespace Phacil\Framework\Exception;
+
+/**
+ * Exception for Rest API
+ * @package Phacil\Framework\Exception
+ */
+class WebApiException extends \Phacil\Framework\Exception {
+
+	/**
+	 * Error HTTP response codes.
+	 */
+	const HTTP_BAD_REQUEST = 400;
+
+	const HTTP_UNAUTHORIZED = 401;
+
+	const HTTP_FORBIDDEN = 403;
+
+	const HTTP_NOT_FOUND = 404;
+
+	const HTTP_METHOD_NOT_ALLOWED = 405;
+
+	const HTTP_NOT_ACCEPTABLE = 406;
+
+	const HTTP_INTERNAL_ERROR = 500;
+
+	/**
+	 * Fault codes that are used in SOAP faults.
+	 */
+	const FAULT_CODE_SENDER = 'Sender';
+	const FAULT_CODE_RECEIVER = 'Receiver';
+
+	/**
+	 * Construct the exception. Note: The message is NOT binary safe.
+	 * 
+	 * @param string|array $message 
+	 * @param int $code 
+	 * @param \Phacil\Framework\Exception\Throwable|null $previous 
+	 * @return void 
+	 */
+	public function __construct($message = "", int $code = 400, $previous = null) {
+		parent::__construct((is_array($message) ? \Phacil\Framework\Json::encode($message) : $message), $code, $previous);
+	}
+
+}
\ No newline at end of file
diff --git a/system/arrayClass/Aux/LegacyAux.php b/system/arrayClass/Aux/LegacyAux.php
new file mode 100644
index 0000000..df15728
--- /dev/null
+++ b/system/arrayClass/Aux/LegacyAux.php
@@ -0,0 +1,79 @@
+<?php
+/*
+ * Copyright © 2023 ExacTI Technology Solutions. All rights reserved.
+ * GPLv3 General License.
+ * https://exacti.com.br
+ */
+
+
+namespace Phacil\Framework\ArrayClass\Aux; 
+
+abstract class LegacyAux
+{
+	protected $_container = array();
+
+	/**
+	 * Assigns a value to the specified offset
+	 *
+	 * @param string $offset The offset to assign the value to
+	 * @param mixed  $value The value to set
+	 * @access public
+	 * @abstracting ArrayAccess
+	 * 
+	 * @return void
+	 */
+	public function offsetSet($offset, $value)
+	{
+		if (is_string($offset)) $offset = strtolower($offset);
+		if (is_null($offset)) {
+			$this->_container[] = $value;
+		} else {
+			$this->_container[$offset] = $value;
+		}
+	}
+
+	/**
+	 * Whether or not an offset exists
+	 *
+	 * @param string $offset An offset to check for
+	 * @access public
+	 * @return bool
+	 * @abstracting ArrayAccess
+	 */
+	public function offsetExists($offset)
+	{
+		if (is_string($offset)) $offset = strtolower($offset);
+		return isset($this->_container[$offset]);
+	}
+
+	/**
+	 * Unsets an offset
+	 *
+	 * @param string $offset The offset to unset
+	 * @access public
+	 * @abstracting ArrayAccess
+	 * 
+	 * @return void
+	 */
+	public function offsetUnset($offset)
+	{
+		if (is_string($offset)) $offset = strtolower($offset);
+		unset($this->_container[$offset]);
+	}
+
+	/**
+	 * Returns the value at specified offset
+	 *
+	 * @param string $offset The offset to retrieve
+	 * @access public
+	 * @return mixed
+	 * @abstracting ArrayAccess
+	 */
+	public function offsetGet($offset)
+	{
+		if (is_string($offset)) $offset = strtolower($offset);
+		return isset($this->_container[$offset])
+			? $this->_container[$offset]
+			: null;
+	}
+}
\ No newline at end of file
diff --git a/system/arrayClass/Aux/ModernAux.php b/system/arrayClass/Aux/ModernAux.php
new file mode 100644
index 0000000..a3b8bdc
--- /dev/null
+++ b/system/arrayClass/Aux/ModernAux.php
@@ -0,0 +1,80 @@
+<?php
+/**
+ * Copyright © 2023 ExacTI Technology Solutions. All rights reserved.
+ * GPLv3 General License.
+ * https://exacti.com.br
+ * Phacil PHP Framework - https://github.com/exacti/phacil-framework
+ */
+
+
+namespace Phacil\Framework\ArrayClass\Aux; 
+
+abstract class ModernAux
+{
+	protected $_container = array();
+
+	/**
+	 * Assigns a value to the specified offset
+	 *
+	 * @param string $offset The offset to assign the value to
+	 * @param mixed  $value The value to set
+	 * @access public
+	 * @abstracting ArrayAccess
+	 * 
+	 * @return void
+	 */
+	public function offsetSet($offset, $value): void
+	{
+		if (is_string($offset)) $offset = strtolower($offset);
+		if (is_null($offset)) {
+			$this->_container[] = $value;
+		} else {
+			$this->_container[$offset] = $value;
+		}
+	}
+
+	/**
+	 * Whether or not an offset exists
+	 *
+	 * @param string $offset An offset to check for
+	 * @access public
+	 * @return bool
+	 * @abstracting ArrayAccess
+	 */
+	public function offsetExists($offset): bool
+	{
+		if (is_string($offset)) $offset = strtolower($offset);
+		return isset($this->_container[$offset]);
+	}
+
+	/**
+	 * Unsets an offset
+	 *
+	 * @param string $offset The offset to unset
+	 * @access public
+	 * @abstracting ArrayAccess
+	 * 
+	 * @return void
+	 */
+	public function offsetUnset($offset): void
+	{
+		if (is_string($offset)) $offset = strtolower($offset);
+		unset($this->_container[$offset]);
+	}
+
+	/**
+	 * Returns the value at specified offset
+	 *
+	 * @param string $offset The offset to retrieve
+	 * @access public
+	 * @return mixed
+	 * @abstracting ArrayAccess
+	 */
+	public function offsetGet($offset): mixed
+	{
+		if (is_string($offset)) $offset = strtolower($offset);
+		return isset($this->_container[$offset])
+			? $this->_container[$offset]
+			: null;
+	}
+}
\ No newline at end of file
diff --git a/system/arrayClass/CaseInsensitiveArray.php b/system/arrayClass/CaseInsensitiveArray.php
new file mode 100644
index 0000000..366b03d
--- /dev/null
+++ b/system/arrayClass/CaseInsensitiveArray.php
@@ -0,0 +1,38 @@
+<?php
+/*
+ * Copyright © 2023 ExacTI Technology Solutions. All rights reserved.
+ * GPLv3 General License.
+ * https://exacti.com.br
+ */
+
+namespace Phacil\Framework\ArrayClass;
+
+if (version_compare(phpversion(), "7.1.0", "<")) {
+
+	class supCaseComp extends \Phacil\Framework\ArrayClass\Aux\LegacyAux {
+		
+	}
+
+} else {
+	class supCaseComp extends \Phacil\Framework\ArrayClass\Aux\ModernAux
+	{
+		
+	}
+
+}
+
+class CaseInsensitiveArray extends supCaseComp implements \ArrayAccess
+{
+	protected $_container = array();
+
+	/**
+	 * @param array $initial_array 
+	 * @return void 
+	 */
+	public function __construct(array $initial_array = array())
+	{
+		//$this->_container = array_map("strtolower", $initial_array);
+		$this->_container = array_change_key_case($initial_array);
+	}
+
+}
\ No newline at end of file