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.

$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:

$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.

$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.

$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.

$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.

$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.

$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

Functions

Methods

Constructors and Destructors

Object-Oriented Types

Properties

Constants

Parameters

Variables

Traits

Attributes

Control Flow

Loops

Error Handling

Namespaces

File Inclusion

Built-In Types

Comments

Access Operators

Conditional Operators

Comparison Operators

Logical Operators

Type Operators

Arithmetic Operators

String Operators

Assignment Operators

Sign & Increment Operators

Special Unary Operators

Bitwise Operators

PHP Global Variable

The `global` Keyword

The `$GLOBALS` Superglobal Array

Variable Variables and Global Scope

​The global Keyword

​The $GLOBALS Superglobal Array

​Variable Variables and Global Scope

The `global` Keyword

The `$GLOBALS` Superglobal Array

Variable Variables and Global Scope