PHP 多層 include 導致 global 失效？$GLOBALS 陣列完美解決

PHP 多層 include 導致 global 失效？$GLOBALS 陣列完美解決

在 PHP 專案中，當多個檔案透過 include 串聯載入時，常會遇到在深層檔案的函式內使用 global $var 無法存取最外層定義的全域變數。本文解析成因並提供最佳實踐解法。

問題重現

<?php
// a.php
$aa = 1;
?>

// b.php
<?php
include 'a.php';
function show() {
    global $aa;
    var_dump($aa); // 輸出：NULL
}
show();
?>

明明在 a.php 定義了 $aa = 1，為何在 b.php 的函式中 global $aa 卻抓不到？

成因分析

global $var 的作用是將當前腳本作用域的變數引入函式區域作用域。當透過多層 include 時，PHP 的作用域鏈結可能不如預期，導致「當前腳本作用域」並非定義變數的那個檔案層級，進而找不到目標變數。

最佳解法：使用 $GLOBALS 超全域陣列

$GLOBALS 是 PHP 內建的超全域變數，以關聯陣列形式儲存所有全域變數（鍵為變數名，值為變數值）。它不受作用域限制，在任何函式、類別、檔案層級都能直接存取。

<?php
// a.php - 使用 $GLOBALS 定義
$GLOBALS['aa'] = 1;
?>

// b.php
<?php
include 'a.php';
function show() {
    // 直接存取 $GLOBALS，無需 global 關鍵字
    var_dump($GLOBALS['aa']); // 輸出：int(1)
}
show();
?>

為何 $GLOBALS 總是有效？

• 它是 PHP 核心層面維護的全域符號表，獨立於檔案包含層級。
• 不依賴 global 關鍵字的作用域解析機制。
• 跨檔案、跨函式、跨類別方法均可直接讀寫。

替代方案對比

最佳實踐建議

1. 若變數需在多檔案、多函式間共享且可變，優先使用 $GLOBALS。
2. 配合命名慣例（如 $GLOBALS['APP_CONFIG']）避免鍵名衝突。
3. 大型專案建議封裝為 Config::get('key') 靜態方法，內部使用 $GLOBALS，提升可維護性。