phpgt / protectedglobal
Protect against accidental use of superglobals.
Installs: 2 418
Dependents: 2
Suggesters: 0
Security: 0
Stars: 0
Watchers: 3
Forks: 3
Open Issues: 5
Requires
- php: >7.4
Requires (Dev)
- phpstan/phpstan: ^v1.8
- phpunit/phpunit: ^v9.5
This package is auto-updated.
Last update: 2024-11-10 14:53:21 UTC
README
By default, PHP passes all sensitive user information around in superglobal variables, available for reading and modification in any code, including third party libraries. This directly violates a lot of the benefits of Object Oriented Programming, and can lead to unmaintainable code.
Assuming there are object oriented abstractions to the superglobals set up, this library can be used to replace all superglobals with objects that alert the developer of their protection and encapsulation, with an optional whitelist of superglobals to keep.
There are two functions on the static Protection
class:
removeGlobals
- pass in an array containing the global arrays you wish to empty. Take an optional whitelist of keys to keep.overrideInternals
- pass in all superglobal arrays to override with theProtectedGlobal
class.
Example usage:
// Before protecting, abstract the globals using an OOP mechanism of choice. $input = new Input($_GET, $_POST, $_FILES); // etc... Protection::removeGlobals([$_ENV, $_SERVER, $_GET, $_POST, $_FILES, $_COOKIE, $_SESSION], ["get" => ["xdebug"]]); Protection::overrideInternals($_GLOBALS, $_ENV, $_SERVER, $_GET, $_POST, $_FILES, $_COOKIE, $_SESSION); // Now an exception will be thrown when trying to access a global variable: $_SESSION["god-object"] = "Value I want to pass around globally";