PHP 多次 Include 導致全域變數失效的解決方案

問題背景

在 PHP 開發中，當多個檔案透過 include 依序載入時，常會遇到最後一個檔案內的函式無法透過 global 關鍵字存取全域變數的情況。這是一個經典的作用域問題，許多開發者初次遇到時會感到困惑。

問題重現

假設有兩個檔案：

a.php

<?php
$aa = 1;
?>

b.php

<?php
include 'a.php';
function show() {
    global $aa;
    var_dump($aa);
}
?>

執行結果會顯示 null，而非預期的 1。這是因為 include 發生在函式外部，但全域變數的宣告卻在被包含的檔案中，導致作用域鏈斷裂。

核心解決方案：使用 $GLOBALS 超全域陣列

最可靠的做法是直接使用 $GLOBALS 超全域陣列來定義與存取跨檔案共享的變數。修改 a.php 如下：

<?php
$GLOBALS['aa'] = 1;
?>

接著在任何被包含檔案的函式或方法中，即可透過 $GLOBALS['aa'] 正確讀寫該變數，不再受限於 global 關鍵字的作用域限制。

為什麼 $GLOBALS 總是有效？

• $GLOBALS 是 PHP 內建的超全域變數，在腳本的任何位置都可直接存取，無需宣告。
• 它不受函式、類別、檔案包含層級的影響，真正實現了「全域」共享。
• 適合用於設定檔、共用常數、快取物件等跨模組資料交換場景。

最佳實踐建議

1. 若變數需在多個獨立檔案間共享，優先採用 $GLOBALS['key'] 寫法。
2. 避免在函式內部使用 global $var 搭配多層 include，維護成本高且易出錯。
3. 大型專案建議改用依賴注入或服務容器管理共享狀態，降低全域狀態依賴。

掌握這項技巧，能有效解決 PHP 多檔案包含時的變數作用域難題，提升代碼健壯性。