phpmyadmin 5.2 默认不启用 metro 主题,需手动下载 all-languages 包、确认 ./themes/metro 存在,并在 config.inc.php 中正确设置 $cfg['themedefault'] = 'metro'; 后重新登录生效。

phpMyAdmin 5.2 默认不启用 Metro 主题,且该主题在 v5.2 中已内置但未设为默认——你得手动启用,不能靠界面点选切换。
确认 Metro 主题是否实际存在
phpMyAdmin 5.2 的主题路径是 ./themes/metro/,不是老版本的 ./themes/original/ 或 ./themes/bootstrap/。执行以下命令验证:
ls -d ./themes/metro
如果报错 “No such file or directory”,说明你装的是精简版(比如 phpMyAdmin-5.2.1-english.tar.gz),它不含多语言和额外主题。必须重下 all-languages 包:
- 删掉当前目录:
rm -rf ./themes/metro - 重新下载完整包:
wget https://files.phpmyadmin.net/phpMyAdmin/5.2.1/phpMyAdmin-5.2.1-all-languages.tar.gz - 解压覆盖:
tar -xzf phpMyAdmin-5.2.1-all-languages.tar.gz --strip-components=1 -C .
修改 config.inc.php 启用 Metro 主题
主题切换不是前端操作,而是服务端配置。编辑 config.inc.php,在 $i++ 之后、任何 $cfg['Servers'] 设置之前插入:
$cfg['ThemeDefault'] = 'metro';
注意两点:
- 别写成
$cfg['ThemeDefault'] = 'Metro';(大小写敏感,必须小写) - 不要加引号外的空格,比如
' metro '会导致加载失败,页面空白且无错误提示 - 该设置只影响新会话;已登录用户需退出后重新登录才生效
Metro 主题没有“暗黑模式”开关,但可手动改 CSS
Metro 主题本身是浅色 UI(白底蓝字),所谓“暗黑”需自行调整。它的样式入口在:
./themes/metro/css/theme.css
常见可改项:
- 主背景:
body { background-color: #121212; } - 表格行交替色:
tr:nth-child(even) { background-color: #1e1e1e; } - 输入框边框:
input, select, textarea { border-color: #333; }
改完记得清浏览器缓存(Ctrl+Shift+R),否则 CSS 不刷新。另外,升级 phpMyAdmin 时这个文件会被覆盖——如需持久化,建议用 @import 方式引入外部 CSS,再通过 Nginx alias 指向自托管路径。
访问时仍显示 Bootstrap 或 Original?检查这三处
即使配置正确,仍可能回退到默认主题,原因通常是:
-
config.inc.php中有重复的$cfg['ThemeDefault']定义,后写的被忽略 - PHP 报错导致配置提前终止(比如语法错误),检查
/var/log/php-fpm/www-error.log是否有 parse error - 浏览器 localStorage 缓存了上次选的主题:打开开发者工具 → Application → Local Storage → 找到
phpMyAdmin_theme键,删掉它
主题加载失败时不会报错,只会静默 fallback 到 pmahomme(v5.2 默认主题),这点特别容易被忽略。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











