PHP 8.3 默认启用更严格的变量检查，而 phpMyAdmin（尤其旧版本如 5.2.x）大量使用未显式初始化的变量（如 $cfg 数组键、$pma_token、$sql_query 等），导致页面顶部或日志中频繁出现 Notice: Undefined variable。这不是配置错误，而是代码兼容性断层——必须在不降级 error reporting 的前提下修复变量声明逻辑。
为什么 PHP 8.3 会突然报大量未定义变量？
PHP 8.3 强化了对“未初始化变量读取”的运行时检测（尤其在 array key 访问、函数参数默认值推导、动态属性赋值等场景）。phpMyAdmin 中常见模式如：$cfg['Servers'][$i]['controluser'] 在 $i 未被循环赋值前就被读取；isset($sql_query) 前直接 echo $sql_query；或模板里直接插值 =$pma_token?> 而无兜底。这些在 PHP 7.4–8.2 中仅触发 Notice（常被屏蔽），但在 8.3+ 的默认 E_ALL 下必然暴露。
- PHP 8.3 不再容忍“隐式 null fallback”：未声明变量不再自动视为
null，而是直接抛 Notice - phpMyAdmin 的
libraries/目录下大量脚本依赖全局变量注入（如$_GET自动转为局部变量），该机制在register_globals=off（现代 PHP 默认）下已失效，但部分老代码仍假设变量存在 - 错误不是出在你的配置文件，而是 phpMyAdmin 自身源码中缺乏
??、isset()或默认初始化
修复 config.inc.php 中的未定义变量引用
最常见的报错点是 config.inc.php 中对 $i 的误用。当只配置一个服务器时，$i 并非自动为 1，而是需显式声明或遍历 $cfg['Servers'] 数组获取有效索引。
- 不要写：
$cfg['Servers'][$i]['controluser'] = 'pma';（$i未定义） - 改用显式索引：
$cfg['Servers'][1]['controluser'] = 'pma';（确保你只配了第 1 个服务器） - 或安全遍历：
foreach ($cfg['Servers'] as $i => $server) { if (!empty($server['host'])) { $cfg['Servers'][$i]['controluser'] = 'pma'; $cfg['Servers'][$i]['controlpass'] = 'your_pass'; break; } } - 检查所有
$cfg['Servers'][$i]引用，包括auth_type、socket、verbose等字段，全部补上isset($cfg['Servers'][$i])判断或统一用固定数字索引
修补 templates 和 libraries 中的变量未初始化问题
核心修复位置在 templates/ 和 libraries/classes/ 下的 PHP 模板文件（如 navigation/main.twig.php、display/export/options_form.twig.php）。这些文件常直接输出未声明变量。
立即学习“PHP免费学习笔记（深入）”；
- 定位报错行（查看 PHP 错误日志中的 file:line）：找到类似
echo $export_type;或if ($is_superuser) { ... }的语句 - 统一加初始化或空合并：
$export_type = $export_type ?? 'sql';或echo $export_type ?? ''; - 对布尔型变量（如
$is_superuser），不能只写isset($is_superuser) ? $is_superuser : false，应提前在逻辑入口处赋值：$is_superuser = $GLOBALS['dbi']->isSuperUser() ?? false; - 禁用
@抑制符：它在 PHP 8.3 中对未定义变量无效，且掩盖真实问题
关键细节：别忽略 session 和 token 变量的初始化时机
phpMyAdmin 依赖 $pma_token 和 $_SESSION 数据生成表单 CSRF token，但 PHP 8.3 下 session_start() 后若未显式初始化 $_SESSION[' PMA_token '] ，后续模板中 $pma_token 就会未定义。
- 在
libraries/common.inc.php靠近session_start()后添加：if (!isset($_SESSION[' PMA_token '])) { $_SESSION[' PMA_token '] = bin2hex(random_bytes(32)); } $pma_token = $_SESSION[' PMA_token '] ?? ''; - 注意空格：官方代码中键名为
' PMA_token '（前后带空格），不是'PMA_token'，拼错会导致始终未命中 - 所有模板中对
$pma_token的引用，必须确保其作用域包含该赋值逻辑，否则即使加??也无效
真正难处理的不是单个变量，而是 phpMyAdmin 中大量“条件分支后变量作用域泄漏”——比如某个 if (PMA_DRIZZLE) 分支内定义了 $sql，但 else 分支没定义，外部却直接用了。这类问题必须逐文件检查控制流，不能靠全局 error_reporting 降级来绕过。
