PHP global 關鍵字與全域變數作用域完整解析：跨函式存取、include 陷阱、最佳替代方案

PHP 變數作用域規則

PHP 採用函式級作用域：函式內部預設無法存取外部變數，外部也無法直接存取函式內部變數。global 關鍵字建立「別名綁定」，讓函式內部變數指向全域符號表同一個 zval。

基本用法

<?php
$globalVar = 'external';

function testGlobal() {
    global $globalVar; // 宣告使用全域變數
    echo $globalVar;   // 輸出 external
    $globalVar = 'modified';
}

testGlobal();
echo $globalVar; // 輸出 modified（外部變數被修改）
?>

在函式內定義全域變數

<?php
function defineGlobal() {
    global $newGlobal;
    $newGlobal = 'created in function';
}

defineGlobal();
echo $newGlobal; // 輸出 created in function
?>

⚠️ include 陷阱：被包含檔案的作用域跟隨呼叫處

<?php
// A.php
function loadConfig() {
    include 'config.php'; // 在函式內 include
    // config.php 內的 $config 變成 loadConfig() 的區域變數！
}
loadConfig();
// 這裡無法存取 $config
?>

<?php
// config.php
$config = ['db' => 'localhost']; // 這裡的 $config 屬於 loadConfig() 區域作用域
?>

解決方案 1：移出 include

<?php
include 'config.php'; // 全域範圍 include
function loadConfig() {
    global $config; // 明確宣告
    // 使用 $config
}
?>

解決方案 2：回傳值（推薦）

<?php
// config.php
return ['db' => 'localhost'];

// A.php
$config = include 'config.php'; // 取得回傳陣列
function loadConfig($config) {
    // 參數傳遞，無作用域問題
}
?>

解決方案 3：參考傳遞存取器

<?php
function setGlobal(&$var) {
    $var = 'new value';
}

$value = 'old';
setGlobal($value);
echo $value; // new value
?>

$GLOBALS 超全域陣列：更明確的替代方案

<?php
$x = 1;
function test() {
    $GLOBALS['x'] = 2; // 直接操作全域符號表
}
test();
echo $x; // 2
?>

• $GLOBALS['var'] 不需宣告 global，語意清晰：明確存取全域。
• 避免 global $var 易被忽略、誤以為區域變數。
• 效能相當，建議優先使用 $GLOBALS。

最佳實務總結

現代化替代：依賴注入容器

<?php
// 簡易容器範例
class Container {
    private $services = [];
    public function set($id, callable $factory) { $this->services[$id] = $factory; }
    public function get($id) { return ($this->services[$id])($this); }
}

$container = new Container();
$container->set('config', fn() => include 'config.php');
$container->set('db', fn($c) => new PDO($c->get('config')['dsn'], ...));

// 使用
$db = $container->get('db');
?>

依賴注入（DI）讓相依關係顯性化、可測試、可替換，是現代 PHP 框架（Laravel、Symfony、Yii）的核心架構。