phpMyAdmin 5.0+ 彻底移除 ThemeManager，主题仅支持静态配置 $cfg['ThemePath'] 指向 pmahomme 或 original，运行时切换失效；4.x 版本虽保留该功能，但受限于兼容性与配置要求。

phpMyAdmin 5.0+ 已移除 ThemeManager 和主题切换功能，官方不再支持运行时多主题切换。 所有“通过配置 ThemeManager 实现多主题切换”的尝试，都会在新版中失败——不是配置不对，而是代码已删除。

为什么 ThemeManager 在 phpMyAdmin 中彻底失效

从 phpMyAdmin 5.0.0 开始，ThemeManager 类、themes/ 目录加载逻辑、前端主题选择 UI 全部被移除。官方明确将主题固化为 pmahomme（默认深色）和 original（经典浅色）两种，且只能通过 $cfg['ThemePath'] 静态指定一个路径，不接受用户会话级切换。

• 查看 libraries/classes/ThemeManager.php？该文件在 5.0+ 版本中已不存在
• 访问 index.php?theme=xxx 或提交 theme 表单字段？请求参数被完全忽略
• 检查 config.inc.php 中的 $cfg['ThemeManager'] = true;？该配置项已被废弃，设了也无效果

实际可用的主题控制方式（仅限 5.0+）

你只能通过修改配置和文件系统来“换主题”，但这是部署级操作，非用户级切换：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

• 使用 $cfg['ThemePath'] = 'themes/pmahomme'; 指向内置主题目录（注意路径不含尾部斜杠）
• 手动替换 themes/pmahomme/ 下的 CSS/JS 文件可定制外观，但整个实例统一生效
• 若需并存多个视觉风格，必须部署多个 phpMyAdmin 实例（不同 config.inc.php + 不同 ThemePath），并通过反向代理或子路径区分
• 第三方主题（如 metro, bootstrap）基本停止维护，且无法适配 5.2+ 的 Twig 模板结构

如果你正在用 phpMyAdmin 4.x 并想启用 ThemeManager

仅此版本范围（4.9.x 及更早）仍保留该功能，但需满足三个硬性条件：

立即学习“PHP免费学习笔记（深入）”；

• $cfg['ThemeManager'] = true; 必须出现在 config.inc.php 中，且不能被注释或覆盖
• themes/ 目录需存在且包含至少一个符合结构的子目录（如 themes/original/ 内含 info.inc.php 和 css/theme.css）
• Web 服务器需允许对 themes/ 目录的读取（常见坑：open_basedir 限制或 SELinux 拒绝访问）
• 浏览器端需启用 Cookie，因为主题偏好存储在 phpMyAdmin 域的 pma_theme cookie 中

真正棘手的地方在于：即使你成功回退到 4.9.7 并配好 ThemeManager，现代浏览器对旧版 jQuery/CSS 的兼容性问题（比如 Flexbox 缺失、rem 单位渲染异常）会导致部分主题界面错乱——这不是配置问题，是技术栈断层。