Introducing SG: A PHP Syntax‑Sugar Extension for Simplified Superglobal Access

The article presents SG (Superglobals), a PHP syntax‑sugar extension that provides a novel method for accessing and manipulating PHP superglobal variables.

It begins by explaining the concept of syntax sugar as a lightweight, developer‑friendly way to write more readable and maintainable code without affecting language semantics or performance.

SG expands the traditional set of PHP superglobals (_SERVER, _GET, _POST, _FILES, _COOKIE, _SESSION, _REQUEST, _ENV) and allows custom variables to be treated similarly, offering a simple and intuitive API.

Project background highlights goals such as simplifying HTTP parameter retrieval, applying unified filtering, conversion, and decryption, performing predefined operations before fetching values, and updating the corresponding PHP superglobal only when declared.

The project is hosted at https://github.com/yulonghu/sg and supports a wide range of PHP versions, as shown in the accompanying compatibility chart.

Key features include:

Simple, fast, lightweight design.

Zero‑copy access to superglobals with automatic synchronization.

Custom pre‑fetch functions (e.g., automatic trim on strings).

Resolution of undefined variable/offset errors.

Static method syntax using dot notation for array dimensions.

Global declaration syntax using an underscore for array dimensions.

Configurable global variable lookup depth (default is one level).

Configuration is performed via php.ini settings (illustrated in the configuration diagram).

Hash map and flowchart images illustrate the internal mapping and processing flow of SG.

Two declaration styles are demonstrated: the PHP 7‑style global declaration and a functional API. Example code snippets include:

sg.global_level = 1

sg.global_level = 0

sg.func_name

get/set/has/del()

Performance testing was conducted with ab -c100 -n10000 . Results show that SG’s global declaration method performs comparably to the default PHP approach while providing the added syntactic benefits.

In conclusion, SG is compatible with current mainstream PHP versions, enriches superglobal usage with a sweeter syntax, and adheres to the principle that simplicity is paramount. Note: the current global declaration method only supports immutable variable names.