> ## Documentation Index
> Fetch the complete documentation index at: https://docs.syntblaze.com/llms.txt
> Use this file to discover all available pages before exploring further.
# PHP Global Variable
A global variable in PHP is a variable declared in the main script, outside of any function, method, or class context. It resides in the global symbol table and persists throughout the execution lifecycle of the script. Unlike languages such as C or JavaScript, PHP does not automatically resolve global variables inside local scopes. To access a global variable within a function or method, explicit importation or referencing is required.
PHP provides two primary mechanisms for accessing global variables from within a local scope: the `global` keyword and the `$GLOBALS` superglobal array.
## The `global` Keyword
The `global` keyword is used inside a local scope to import a variable from the global symbol table into the local symbol table.
```php theme={"dark"}
$value = 100; // Declared in the global scope
function incrementValue() {
global $value; // Imports the global variable into the local scope
$value++;
}
incrementValue();
echo $value; // Outputs: 101
```
Under the hood, using the `global` keyword creates a reference (alias) to the global variable. The statement `global $value;` is semantically equivalent to:
```php theme={"dark"}
$value = &$GLOBALS['value'];
```
Because it creates a local reference, using the `unset()` function on a variable imported via the `global` keyword only severs the local reference; it does not destroy the variable in the global symbol table.
```php theme={"dark"}
$config = 'active';
function removeConfig() {
global $config;
unset($config); // Only destroys the local reference
}
removeConfig();
echo $config; // Outputs: active
```
## The `$GLOBALS` Superglobal Array
`$GLOBALS` is a built-in associative array containing references to all variables currently defined in the global scope. The keys of the array are the names of the global variables, and the values are the contents of those variables.
Because `$GLOBALS` is a *superglobal*, it is automatically available in all scopes without requiring explicit importation.
```php theme={"dark"}
$counter = 5;
function updateCounter() {
// Direct access and modification via the superglobal array
$GLOBALS['counter'] *= 2;
}
updateCounter();
echo $counter; // Outputs: 10
```
Unlike the `global` keyword, `$GLOBALS` accesses the actual global variable directly rather than creating a local alias. Consequently, using `unset()` on an element within the `$GLOBALS` array will completely destroy the variable in the global symbol table.
```php theme={"dark"}
$session_id = 'xyz123';
function destroySession() {
unset($GLOBALS['session_id']); // Destroys the actual global variable
}
destroySession();
var_dump(isset($session_id)); // Outputs: bool(false)
```
## Variable Variables and Global Scope
When using variable variables (dynamic variable names) with the `global` keyword, the variable holding the dynamic name is resolved in the **local** scope to determine which global variable to import.
```php theme={"dark"}
$target = 'database';
$database = 'MySQL';
function resolveDynamicGlobal() {
global $target; // Imports $target into the local scope first
// $target is resolved locally to 'database'
// This statement is evaluated as: global $database;
global $$target;
echo $database; // Outputs: MySQL
}
resolveDynamicGlobal();
```
PHP imposes a strict limitation regarding superglobals and variable variables: **superglobals cannot be used as variable variables inside functions or methods**. When a variable variable is evaluated dynamically, PHP does not apply the special scope-bypassing rules of superglobals. Instead, it looks for a standard local variable matching that name.
```php theme={"dark"}
$database = 'PostgreSQL';
function testSuperglobalVariable() {
$varName = 'GLOBALS';
// This fails to return the superglobal array.
// PHP looks for a standard local variable literally named $GLOBALS.
var_dump($$varName); // Outputs: Warning: Undefined variable $GLOBALS
}
testSuperglobalVariable();
```
Tired of Poor PHP Skills? Fix That With Deep Grasping!
Learn More
