如何在Linux服务器中为phpMyAdmin批量部署多套主题？-phpMyAdmin-PHP中文网

phpmyadmin 不支持批量部署主题，所有主题均为硬编码在 themes/ 目录下的 css/js 组合，需手动复制合法主题目录并配置 $cfg['themedefault'] 和 $cfg['thememanager']。

如何在linux服务器中为phpmyadmin批量部署多套主题？

phpMyAdmin 不支持“批量部署主题”这个操作

它压根没有主题安装机制，所有所谓“主题”都是前端 CSS/JS 文件的组合，硬编码在 themes/ 目录下，不能像 WordPress 那样上传 ZIP 安装。你看到的 Bootstrap、Metro、Original，其实是同一套代码里切换不同 CSS 类名和模板路径的结果——不是插件，更不是可热插拔组件。

真正能改的只有 `$cfg['ThemeDefault']` 和 `themes/` 目录结构

phpMyAdmin 启动时只读取 themes/ 子目录中符合命名规范的文件夹（如 bootstrap/、pmahomme/），每个文件夹必须包含 theme.php 和 css/theme.css。所谓“部署多个主题”，就是手动把多个合法主题目录放进 themes/，然后在配置里指定默认项：

$cfg['ThemeDefault'] = 'bootstrap'; —— 登录后默认加载的 UI 样式
$cfg['ThemeManager'] = true; —— 允许用户在右上角下拉菜单里手动切换（前提是对应主题目录存在且合法）
主题目录名必须小写、无空格、不含特殊字符；例如 my-custom-theme 可以，My Theme v2 会直接被忽略

复制主题目录时最容易踩的坑

很多人以为只要拷贝一个现成主题改个名就能用，结果登录后界面错乱或功能异常。根本原因是：

Obsidian (Linux)

操作 Obsidian 库（纯 Markdown 笔记），并通过 notesmd-cli 实现自动化。

下载

主题目录里的 theme.php 必须定义 $theme_name 和 $theme_uri，且 $theme_name 要和目录名完全一致（大小写敏感）
css/theme.css 中的相对路径（比如引用 images/ 下的图标）是基于主题根目录解析的，挪动位置后路径就断了
Bootstrap 主题依赖 PHPMyAdmin 5.0+ 的 JS 模块加载机制，如果强行塞进 4.9.x 版本，$(document).ready() 里调用的函数可能根本不存在
修改完 themes/ 后必须清空浏览器缓存 + 重启 Web 服务（Apache/Nginx），否则旧 CSS/JS 会被 304 缓存住

想让多个站点用不同主题？别动 `themes/`，改配置逻辑

phpMyAdmin 本身不支持 per-site 主题隔离。如果你在宝塔或 Nginx 下托管多个子路径（如 /pma-dev、/pma-prod），唯一可行的办法是在入口脚本（index.php 或自定义 config.inc.php）里根据 $_SERVER['REQUEST_URI'] 动态覆盖 $cfg['ThemeDefault']：

if (strpos($_SERVER['REQUEST_URI'], '/pma-dev') === 0) {
    $cfg['ThemeDefault'] = 'pmahomme';
} elseif (strpos($_SERVER['REQUEST_URI'], '/pma-prod') === 0) {
    $cfg['ThemeDefault'] = 'bootstrap';
}

这种写法绕过了主题系统的设计边界，但比硬塞一堆主题目录更可控——毕竟你真正需要的从来不是“多套主题共存”，而是“不同环境呈现不同视觉风格”。主题目录放太多，反而增加维护负担和潜在冲突风险。