Globals.php$0 ➔ has() - Code Metrics - Inspection of "Update CHANGELOG.md" - MarwanAlsoltany/velox - Measure and Improve Code Quality continuously with Scrutinizer

Passed

Push — master ( 3eae2e...db39cf )

by Marwan

created 2021-08-26 04:17 UTC

Globals.php$0 ➔ has() A

↳ Parent: anonymous//classes/Backend/Globals.php$0

Complexity

Conditions

Size

Total Lines

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	0
CRAP Score	2

Importance

Changes	1
Bugs	0	Features	0

Metric	Value
cc	1
c	1
b	0
f	0
dl	0
loc	4
ccs	0
cts	2
cp	0
crap	2
rs	10

<?php

/**
 * @author Marwan Al-Soltany <[email protected]>
 * @copyright Marwan Al-Soltany 2021
 * For the full copyright and license information, please view
 * the LICENSE file that was distributed with this source code.
 */

declare(strict_types=1);

namespace MAKS\Velox\Backend;

use MAKS\Velox\Helper\Misc;

/**
 * A class that serves as an abstraction/wrapper to work with superglobals.
 *
 * @method static mixed getGet(string $key = null) Gets a value from $_GET. Dot-notation can be used for nested values.
 * @method static mixed getPost(string $key = null) Gets a value from $_POST. Dot-notation can be used for nested values.
 * @method static mixed getFiles(string $key = null) Gets a value from $_FILES. Dot-notation can be used for nested values.
 * @method static mixed getCookie(string $key = null) Gets a value from $_COOKIE. Dot-notation can be used for nested values.
 * @method static mixed getSession(string $key = null) Gets a value from $_SESSION. Dot-notation can be used for nested values.
 * @method static mixed getRequest(string $key = null) Gets a value from $_REQUEST. Dot-notation can be used for nested values.
 * @method static mixed getServer(string $key = null) Gets a value from $_SERVER. Dot-notation can be used for nested values.
 * @method static mixed getEnv(string $key = null) Gets a value from $_ENV. Dot-notation can be used for nested values.
 * @method static static setGet(string $key, $value) Sets a value in $_GET. Dot-notation can be used for nested values.
 * @method static static setPost(string $key, $value) Sets a value in $_POST. Dot-notation can be used for nested values.
 * @method static static setFiles(string $key, $value) Sets a value in $_FILES. Dot-notation can be used for nested values.
 * @method static static setCookie(string $key, $value) Sets a value in $_COOKIE. Dot-notation can be used for nested values.
 * @method static static setSession(string $key, $value) Sets a value in $_SESSION. Dot-notation can be used for nested values.
 * @method static static setRequest(string $key, $value) Sets a value in $_REQUEST. Dot-notation can be used for nested values.
 * @method static static setServer(string $key, $value) Sets a value in $_SERVER. Dot-notation can be used for nested values.
 * @method static static setEnv(string $key, $value) Sets a value in $_ENV. Dot-notation can be used for nested values.
 *
 * @property object $get A class around the superglobal `$_GET` that has the methods `has($key)`, `get($key, $default)`, `set($key, $value)`, and `getAll()`.
 * @property object $post A class around the superglobal `$_POST` that has the methods `has($key)`, `get($key, $default)`, `set($key, $value)`, and `getAll()`.
 * @property object $files A class around the superglobal `$_FILES` that has the methods `has($key)`, `get($key, $default)`, `set($key, $value)`, and `getAll()`.
 * @property object $cookie A class around the superglobal `$_COOKIE` that has the methods `has($key)`, `get($key, $default)`, `set($key, $value)`, and `getAll()`.
 * @property object $session A class around the superglobal `$_SESSION` that has the methods `has($key)`, `get($key, $default)`, `set($key, $value)`, and `getAll()`.
 * @property object $request A class around the superglobal `$_REQUEST` that has the methods `has($key)`, `get($key, $default)`, `set($key, $value)`, and `getAll()`.
 * @property object $server A class around the superglobal `$_SERVER` that has the methods `has($key)`, `get($key, $default)`, `set($key, $value)`, and `getAll()`.
 * @property object $env A class around the superglobal `$_ENV` that has the methods `has($key)`, `get($key, $default)`, `set($key, $value)`, and `getAll()`.
 *
 * @since 1.0.0
 */
final class Globals
{
    public const GLOBALS = [
        '_GET'     => '_GET',
        '_POST'    => '_POST',
        '_FILES'   => '_FILES',
        '_COOKIE'  => '_COOKIE',
        '_SESSION' => '_SESSION',
        '_REQUEST' => '_REQUEST',
        '_SERVER'  => '_SERVER',
        '_ENV'     => '_ENV',
    ];


    /**
     * This array holds an anonymous class that acts as a wrapper for each superglobal.
     */
    protected static array $globals;

    protected static bool $isInitialized = false;

    private static array $_GET;
    private static array $_POST;
    private static array $_FILES;
    private static array $_COOKIE;
    private static array $_SESSION;
    private static array $_REQUEST;
    private static array $_SERVER;
    private static array $_ENV;


    /**
     * Initializes class internal state from superglobals and returns an instance o it.
     *
     * @return static
     */
    public static function instance()
    {
        static::initialize();

        return new static();
    }

    /**
     * Initializes class internal state from superglobals.
     *
     * @return void
     */
    public static function initialize(): void
    {
        if (!static::$isInitialized) {
            foreach (self::GLOBALS as $global) {
                global $$global;
                self::$$global = isset($$global) ? self::$$global = &$$global : [];
            }

            static::$isInitialized = true;
        }
    }

    /**
     * Gets a value from the specified superglobal.
     *
     * @param string $name The superglobal name to get the value from. Can be written in any case with or without the leading underscore.
     * @param string $key The array element to get from the superglobal. Dot-notation can be used with nested arrays.
     *
     * @return mixed
     *
     * @throws \Exception If the passed name is not a superglobal.
     */
    public static function get(string $name, string $key = null)
    {
        static::initialize();

        $name = static::getValidNameOrFail($name);

        if ($key !== null) {
            return Misc::getArrayValueByKey(self::$$name, $key, null);
        }

        return self::$$name;
    }

    /**
     * Sets a value in the specified superglobal.
     *
     * @param string $name The superglobal name to set the value in. Can be written in any case with or without the leading underscore.
     * @param string $key The array element to set in the superglobal. Dot-notation can be used with nested arrays.
     * @param mixed $value The value to set.
     *
     * @return static
     *
     * @throws \Exception If the passed name is not a superglobal.
     */
    public static function set(string $name, string $key, $value)
    {
        static::initialize();

        $name = static::getValidNameOrFail($name);

        Misc::setArrayValueByKey(self::$$name, $key, $value);

        return new static();
    }

    /**
     * Returns all superglobals.
     *
     * @return array
     */
    public static function getAll(): array
    {
        static::initialize();

        $globals = [];
        foreach (self::GLOBALS as $global) {
            $globals[$global] = self::$$global;
        }

        return $globals;
    }

    /**
     * Returns a valid superglobal name from the passed name.
     *
     * @param string $name
     *
     * @return string
     *
     * @throws \Exception
     */
    private static function getValidNameOrFail(string $name): string
    {
        $variable = '_' . trim(strtoupper($name), '_');

        if (!in_array($variable, self::GLOBALS)) {
            $available = implode(', ', self::GLOBALS);

            throw new \Exception("There is no PHP superglobal with the name '{$name}'. Available superglobals are: [{$available}]");
        }

        return $variable;
    }


    /**
     * Class constructor.
     */
    final public function __construct()
    {
        // the constructor is final to allow to the use of
        // "return new static()" without caring about class dependencies.

        $this->initialize();
    }

    /**
     * Aliases getters and setter for class members.
     */
    public function __get(string $name)
    {
        try {
            $name   = static::getValidNameOrFail($name);
            $global = &self::$$name;

            if (isset(static::$globals[$name])) {
                return static::$globals[$name];
            }

            return static::$globals[$name] = new class($global) {
                private $self;
                public function __construct(&$self)
                {
                    $this->self = &$self;
                }
                public function has(string $key)
                {
                    $value = Misc::getArrayValueByKey($this->self, $key, null);
                    return isset($value);
                }
                public function get(string $key, $default = null)
                {
                    return Misc::getArrayValueByKey($this->self, $key, $default);
                }
                public function set(string $key, $value)
                {
                    Misc::setArrayValueByKey($this->self, $key, $value);
                    return $this;
                }
                public function getAll(): array
                {
                    return $this->self;
                }
            };
        } catch (\Exception $error) {
            throw new \Exception(sprintf('Call to undefined property %s::$%s', static::class, $name), 0, $error);
        }
    }

    /**
     * Allows static methods handled by `self::__callStatic()` to be accessible via object operator `->`.
     */
    public function __call(string $method, array $arguments)
    {
        return static::__callStatic($method, $arguments);
    }

    /**
     * Aliases getters and setter for class members.
     */
    public static function __callStatic(string $name, array $arguments)
    {
        try {
            if (preg_match('/^([gs]et)([_]{0,1}[a-z0-9]+)$/i', $name, $matches)) {
                return forward_static_call_array(
                    [static::class, $matches[1]],
                    [static::getValidNameOrFail($matches[2]), ...$arguments]
                );
            }
        } catch (\Exception $error) {
            throw new \Exception(sprintf('Call to undefined method %s::%s', static::class, $name), 0, $error);
        }
    }
}


1		<?php
2
3		/**
4		* @author Marwan Al-Soltany <[email protected]>
5		* @copyright Marwan Al-Soltany 2021
6		* For the full copyright and license information, please view
7		* the LICENSE file that was distributed with this source code.
8		*/
9
10		declare(strict_types=1);
11
12		namespace MAKS\Velox\Backend;
13
14		use MAKS\Velox\Helper\Misc;
15
16		/**
17		* A class that serves as an abstraction/wrapper to work with superglobals.
18		*
19		* @method static mixed getGet(string $key = null) Gets a value from $_GET. Dot-notation can be used for nested values.
20		* @method static mixed getPost(string $key = null) Gets a value from $_POST. Dot-notation can be used for nested values.
21		* @method static mixed getFiles(string $key = null) Gets a value from $_FILES. Dot-notation can be used for nested values.
22		* @method static mixed getCookie(string $key = null) Gets a value from $_COOKIE. Dot-notation can be used for nested values.
23		* @method static mixed getSession(string $key = null) Gets a value from $_SESSION. Dot-notation can be used for nested values.
24		* @method static mixed getRequest(string $key = null) Gets a value from $_REQUEST. Dot-notation can be used for nested values.
25		* @method static mixed getServer(string $key = null) Gets a value from $_SERVER. Dot-notation can be used for nested values.
26		* @method static mixed getEnv(string $key = null) Gets a value from $_ENV. Dot-notation can be used for nested values.
27		* @method static static setGet(string $key, $value) Sets a value in $_GET. Dot-notation can be used for nested values.
28		* @method static static setPost(string $key, $value) Sets a value in $_POST. Dot-notation can be used for nested values.
29		* @method static static setFiles(string $key, $value) Sets a value in $_FILES. Dot-notation can be used for nested values.
30		* @method static static setCookie(string $key, $value) Sets a value in $_COOKIE. Dot-notation can be used for nested values.
31		* @method static static setSession(string $key, $value) Sets a value in $_SESSION. Dot-notation can be used for nested values.
32		* @method static static setRequest(string $key, $value) Sets a value in $_REQUEST. Dot-notation can be used for nested values.
33		* @method static static setServer(string $key, $value) Sets a value in $_SERVER. Dot-notation can be used for nested values.
34		* @method static static setEnv(string $key, $value) Sets a value in $_ENV. Dot-notation can be used for nested values.
35		*
36		* @property object $get A class around the superglobal `$_GET` that has the methods `has($key)`, `get($key, $default)`, `set($key, $value)`, and `getAll()`.
37		* @property object $post A class around the superglobal `$_POST` that has the methods `has($key)`, `get($key, $default)`, `set($key, $value)`, and `getAll()`.
38		* @property object $files A class around the superglobal `$_FILES` that has the methods `has($key)`, `get($key, $default)`, `set($key, $value)`, and `getAll()`.
39		* @property object $cookie A class around the superglobal `$_COOKIE` that has the methods `has($key)`, `get($key, $default)`, `set($key, $value)`, and `getAll()`.
40		* @property object $session A class around the superglobal `$_SESSION` that has the methods `has($key)`, `get($key, $default)`, `set($key, $value)`, and `getAll()`.
41		* @property object $request A class around the superglobal `$_REQUEST` that has the methods `has($key)`, `get($key, $default)`, `set($key, $value)`, and `getAll()`.
42		* @property object $server A class around the superglobal `$_SERVER` that has the methods `has($key)`, `get($key, $default)`, `set($key, $value)`, and `getAll()`.
43		* @property object $env A class around the superglobal `$_ENV` that has the methods `has($key)`, `get($key, $default)`, `set($key, $value)`, and `getAll()`.
44		*
45		* @since 1.0.0
46		*/
47		final class Globals
48		{
49		public const GLOBALS = [
50		'_GET' => '_GET',
51		'_POST' => '_POST',
52		'_FILES' => '_FILES',
53		'_COOKIE' => '_COOKIE',
54		'_SESSION' => '_SESSION',
55		'_REQUEST' => '_REQUEST',
56		'_SERVER' => '_SERVER',
57		'_ENV' => '_ENV',
58		];
59
60
61		/**
62		* This array holds an anonymous class that acts as a wrapper for each superglobal.
63		*/
64		protected static array $globals;
65
66		protected static bool $isInitialized = false;
67
68		private static array $_GET;
69		private static array $_POST;
70		private static array $_FILES;
71		private static array $_COOKIE;
72		private static array $_SESSION;
73		private static array $_REQUEST;
74		private static array $_SERVER;
75		private static array $_ENV;
76
77
78		/**
79		* Initializes class internal state from superglobals and returns an instance o it.
80		*
81		* @return static
82		*/
83	1	public static function instance()
84		{
85	1	static::initialize();
86
87	1	return new static();
88		}
89
90		/**
91		* Initializes class internal state from superglobals.
92		*
93		* @return void
94		*/
95	41	public static function initialize(): void
96		{
97	41	if (!static::$isInitialized) {
98	1	foreach (self::GLOBALS as $global) {
99	1	global $$global;
100	1	self::$$global = isset($$global) ? self::$$global = &$$global : [];
101		}
102
103	1	static::$isInitialized = true;
104		}
105	41	}
106
107		/**
108		* Gets a value from the specified superglobal.
109		*
110		* @param string $name The superglobal name to get the value from. Can be written in any case with or without the leading underscore.
111		* @param string $key The array element to get from the superglobal. Dot-notation can be used with nested arrays.
112		*
113		* @return mixed
114		*
115		* @throws \Exception If the passed name is not a superglobal.
116		*/
117	18	public static function get(string $name, string $key = null)
118		{
119	18	static::initialize();
120
121	18	$name = static::getValidNameOrFail($name);
122
123	17	if ($key !== null) {
124	16	return Misc::getArrayValueByKey(self::$$name, $key, null);
125		}
126
127	2	return self::$$name;
128		}
129
130		/**
131		* Sets a value in the specified superglobal.
132		*
133		* @param string $name The superglobal name to set the value in. Can be written in any case with or without the leading underscore.
134		* @param string $key The array element to set in the superglobal. Dot-notation can be used with nested arrays.
135		* @param mixed $value The value to set.
136		*
137		* @return static
138		*
139		* @throws \Exception If the passed name is not a superglobal.
140		*/
141	25	public static function set(string $name, string $key, $value)
142		{
143	25	static::initialize();
144
145	25	$name = static::getValidNameOrFail($name);
146
147	24	Misc::setArrayValueByKey(self::$$name, $key, $value);
148
149	24	return new static();
150		}
151
152		/**
153		* Returns all superglobals.
154		*
155		* @return array
156		*/
157	1	public static function getAll(): array
158		{
159	1	static::initialize();
160
161	1	$globals = [];
162	1	foreach (self::GLOBALS as $global) {
163	1	$globals[$global] = self::$$global;
164		}
165
166	1	return $globals;
167		}
168
169		/**
170		* Returns a valid superglobal name from the passed name.
171		*
172		* @param string $name
173		*
174		* @return string
175		*
176		* @throws \Exception
177		*/
178	31	private static function getValidNameOrFail(string $name): string
179		{
180	31	$variable = '_' . trim(strtoupper($name), '_');
181
182	31	if (!in_array($variable, self::GLOBALS)) {
183	5	$available = implode(', ', self::GLOBALS);
184
185	5	throw new \Exception("There is no PHP superglobal with the name '{$name}'. Available superglobals are: [{$available}]");
186		}
187
188	27	return $variable;
189		}
190
191
192		/**
193		* Class constructor.
194		*/
195	41	final public function __construct()
196		{
197		// the constructor is final to allow to the use of
198		// "return new static()" without caring about class dependencies.
199
200	41	$this->initialize();
201	41	}
202
203		/**
204		* Aliases getters and setter for class members.
205		*/
206	1	public function __get(string $name)
207		{
208		try {
209	1	$name = static::getValidNameOrFail($name);
210	1	$global = &self::$$name;
211
212	1	if (isset(static::$globals[$name])) {
213	1	return static::$globals[$name];
214		}
215
216	1	return static::$globals[$name] = new class($global) {
217		private $self;
218		public function __construct(&$self)
219		{
220	1	$this->self = &$self;
221	1	}
222		public function has(string $key)
223		{
224		$value = Misc::getArrayValueByKey($this->self, $key, null);
225		return isset($value);
226		}
227		public function get(string $key, $default = null)
228		{
229	1	return Misc::getArrayValueByKey($this->self, $key, $default);
230		}
231		public function set(string $key, $value)
232		{
233	1	Misc::setArrayValueByKey($this->self, $key, $value);
234	1	return $this;
235		}
236		public function getAll(): array
237		{
238	1	return $this->self;
239		}
240		};
241	1	} catch (\Exception $error) {
242	1	throw new \Exception(sprintf('Call to undefined property %s::$%s', static::class, $name), 0, $error);
243		}
244		}
245
246		/**
247		* Allows static methods handled by `self::__callStatic()` to be accessible via object operator `->`.
248		*/
249	5	public function __call(string $method, array $arguments)
250		{
251	5	return static::__callStatic($method, $arguments);
252		}
253
254		/**
255		* Aliases getters and setter for class members.
256		*/
257	26	public static function __callStatic(string $name, array $arguments)
258		{
259		try {
260	26	if (preg_match('/^([gs]et)([_]{0,1}[a-z0-9]+)$/i', $name, $matches)) {
261	26	return forward_static_call_array(
262	26	[static::class, $matches[1]],
263	26	[static::getValidNameOrFail($matches[2]), ...$arguments]
264		);
265		}
266	2	} catch (\Exception $error) {
267	2	throw new \Exception(sprintf('Call to undefined method %s::%s', static::class, $name), 0, $error);
268		}
269		}
270		}
271

MarwanAlsoltany / velox

Push — master ( 3eae2e...db39cf )

Globals.php$0 ➔ has() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like