phpMyAdmin 4.9 不支持 Metro 主题，因其主题系统未包含 Metro 加载逻辑，强行配置 $cfg['ThemeDefault'] = 'metro'; 无效；必须升级至 ≥5.0 版本，且需满足 PHP ≥7.4、使用 all-languages 包、正确配置并重新登录。
phpMyAdmin 4.9 不支持 Metro 主题 —— 它是 5.0+ 版本才引入的内置主题，强行复制文件或修改配置只会导致空白页或 500 错误。
为什么 config.inc.php 里设 $cfg['ThemeDefault'] = 'metro' 没反应？
因为 phpMyAdmin 4.9 的核心代码里压根没有 metro 主题加载逻辑。它的 ./themes/ 目录下只有 pmahomme（默认）、original、bootstrap 这三个目录，ls ./themes 根本看不到 metro。你写的这行配置会被 PHP 解析，但后续主题初始化时找不到对应目录，最终跳回默认主题或直接中断渲染。
- 检查命令：
ls -d ./themes/metro返回No such file or directory就是铁证 - 即使你手动把 5.2 的
metro文件夹丢进去，也会因函数调用不兼容报错（比如 4.9 没有ThemeManager::getActiveTheme()的新接口） - 错误日志里常见：
PHP Fatal error: Uncaught Error: Class 'PMA\Theme\MetroTheme' not found
想用 Metro 风格，唯一可行路径是升级到 phpMyAdmin ≥ 5.0
不是“加个配置就行”，而是必须换版本。4.9 到 5.0 是架构级升级，主题系统完全重构。以下操作缺一不可：
- 确认 PHP ≥ 7.4（4.9 可跑在 PHP 5.6 上，但 5.0+ 强制要求 7.4+）
- 下载
phpMyAdmin-X.X.X-all-languages.tar.gz（别用-english包，否则metro目录缺失） - 解压后执行
ls ./themes/metro/theme.php确认文件存在且语法有效（PHP 7.4 兼容） - 在
config.inc.php中插入$cfg['ThemeDefault'] = 'metro';，注意：必须小写、无空格、位置在$i++之后、$cfg['Servers']之前 - 已登录用户必须完全退出并重新登录，cookie 会缓存旧主题标识
Docker 环境下启用 Metro 更容易踩坑
容器内路径和权限错一点，主题就加载失败。关键点不是“复制过去”，而是让 PHP 进程启动时能扫描到它：
立即学习“PHP免费学习笔记（深入）”；
- 目标路径必须是
/var/www/html/themes/metro（不是/usr/share/phpmyadmin/themes或挂载到其他位置） - 执行
docker exec phpmyadmin ls -ld /var/www/html/themes/metro，输出应含drwxr-xr-x 1 www-data www-data - 仅
docker restart不够，得docker stop && docker start或重建容器，确保 Apache/FPM 重载全部 PHP 类 - 浏览器强制刷新（
Ctrl+F5），并打开开发者工具 Network 标签，过滤metro.css，确认返回 200 且内容非空
真正生效的标志只有一个：登录后右上角「主题」下拉菜单里出现 metro 选项，且点击后整个 UI 实时变色、去阴影、字体变细——不是靠截图判断，是看交互响应。如果菜单里没它，说明路径、权限、PHP 版本、包完整性四者中至少一个没过。
