global仅在函数内使已存在的全局变量可访问,不创建新变量;需先在外定义,不能跨文件生效,替代方案为传参或$globals。

global 只在函数内部生效,外部变量不会自动变成全局
很多人以为 global 是“把变量声明成全局”,其实它只是在函数作用域里,给一个已存在的全局变量起个别名。如果外面没定义过那个变量,global $x 不会创建 $x,调用时直接报 Notice: Undefined variable。
常见错误现象:
— 函数里写 global $config;,但文件顶部根本没写 $config = [...];
— 误以为 global 能跨文件生效(不能,只管当前作用域的全局符号表)
- 使用前必须确保该变量已在函数外定义(哪怕只是
$foo = null;) - 多个变量用逗号分隔:
global $db, $user_id, $cache_ttl; - 赋值后修改的是原始全局变量,不是副本 — 这点和
global $x; $x = 5;等价于直接操作外部$x
替代 global 的更安全写法:传参 or $GLOBALS
直接依赖 global 容易让函数行为隐式依赖外部状态,测试和复用都变难。多数场景下,显式传参更可控。
使用场景:
— 配置项、数据库连接、日志对象这类“只读上下文”
— 短脚本或遗留代码快速修复,不想大改结构
立即学习“PHP免费学习笔记(深入)”;
- 优先考虑函数参数:
function process($config, $db) { ... },调用方决定传什么 - 想绕过声明又不破坏封装?用
$GLOBALS['config']— 它始终存在,不需要global声明,但可读性差、容易拼错键名 -
global无法用于超全局数组(如$_POST),它们本来就在所有作用域可见
static + global 混用是典型陷阱
有人想“缓存全局变量引用”,在函数里写 static $cache; global $data; if (!$cache) $cache = $data; — 这样第一次运行后,$cache 就和 $data 脱钩了,后续 $data 改变,$cache 不会同步。
性能影响:
— global 本身开销极小,但滥用会导致函数难以单元测试、逻辑耦合变高
— static 变量生命周期长,若它引用了全局大数组,可能意外延长内存占用
- 需要“首次加载后复用”的,应直接在函数内检查并重新读取全局:
if (!isset($GLOBALS['config'])) { /* 加载 */ } - 不要用
global绑定资源句柄(比如$pdo)再存进static,连接可能被关闭或失效 - 调试时注意:
var_dump($GLOBALS)能看到所有全局变量,比猜global声明更可靠
require/ include 后的变量作用域问题
在函数里 include 'config.php',里面定义的 $api_key 默认只在该函数作用域生效,不是全局 — 即使你加了 global $api_key 也无效,因为 include 里的赋值发生在函数局部作用域。
常见错误现象:
— config.php 里写 $host = 'localhost';,函数里 include 后却读不到 $host
— 误以为 include 等同于把代码“粘贴进来”,忽略了作用域隔离
- 想让 include 的变量变成全局?在
config.php里显式写global $host, $port;,再赋值 - 更推荐做法:让 config.php 返回数组,函数里接收:
$cfg = include 'config.php'; - 或者统一用
define()或const定义常量,不受作用域限制
真正麻烦的从来不是语法怎么写,而是搞不清变量到底在哪个符号表里 — 看 get_defined_vars() 和 $GLOBALS 的差异,比背 global 规则管用。











