怎么自定义phpMyAdmin左侧Logo_企业品牌化界面修改-phpMyAdmin-PHP中文网

phpmyadmin 左侧 logo 实际由 css 控制，需修改 #left_panel h1 a 的 background-image；推荐复制主题后改其 css/theme.css，并禁用资源合并以避免缓存问题。

修改 phpmyadmin 左侧 logo 的实际路径和文件名

phpmyadmin 左侧顶部的 logo 图片默认是 ./themes/pmahomme/img/logo_right.png（旧版）或 ./themes/pmahomme/img/logo_left.png（新版 5.2+），但直接替换它不生效——因为该图片由 css 背景属性控制，且路径被硬编码在主题 css 中。

真正要改的是主题 CSS 里的 background-image 声明，不是盲目覆盖图片文件。

先确认你用的主题：默认是 pmahomme，路径通常为 ./themes/pmahomme/
Logo 实际渲染位置在 #left_panel > h1 > a 这个选择器上
不要动 logo_right.png——那是顶部右侧小图标，左侧大 logo 对应的是 logo_left.png
替换前建议备份原图，比如重命名为 logo_left.png.bak

覆盖 CSS 背景图的两种安全方式

直接改主题 CSS 文件（./themes/pmahomme/css/theme.css）风险高，升级 phpMyAdmin 会被覆盖。推荐用自定义 CSS 注入方式：

在 config.inc.php 中添加：$cfg['LeftLogoLink'] = 'https://your-brand.com';（仅改链接，不改图）
更彻底的方案：启用 $cfg['ThemePath'] 并复制一份主题，再修改其 css/theme.css 中的 #left_panel h1 a 规则
最轻量做法：在 config.inc.php 里加 $cfg['Servers'][$i]['auth_type'] = 'cookie'; 后，通过浏览器开发者工具确认最终生效的 CSS 文件路径，再用 file_put_contents() 动态注入样式（仅限开发环境）

示例 CSS 修改片段（放在你复制的主题的 css/theme.css 末尾）：

btpanel phpsite 宝塔面板PHP网站

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

下载

/* 自定义左侧 Logo */
#left_panel h1 a {
  background-image: url(../img/your-logo-left.png) !important;
  width: 180px !important;
  height: 40px !important;
  background-size: contain;
  background-repeat: no-repeat;
  background-position: center;
}

为什么改了 CSS 还不显示？常见加载问题

phpMyAdmin 会缓存 CSS，尤其启用了 $cfg['EnableBundledScripts'] = true;（默认开启）时，所有 CSS 被合并压缩，你的修改不会立即出现。

清除浏览器缓存 + 强制刷新（Ctrl+F5）
临时关闭资源合并：在 config.inc.php 加 $cfg['EnableBundledScripts'] = false;
检查浏览器控制台 Network 标签页，确认请求的 CSS 文件是否返回 200，且内容含你的新规则
如果用了 Nginx/Apache 缓存，也要清理服务器端静态资源缓存
注意路径：CSS 中的 url() 是相对于 CSS 文件所在目录的，不是相对于网页根目录

企业品牌化必须避开的兼容性坑

左侧 Logo 区域高度固定（约 48px），宽度随内容撑开，但过宽的图片会被截断或挤压变形。

推荐尺寸：宽 ≤ 180px，高 ≤ 40px，PNG 透明背景最佳
不要依赖 JS 动态插入 logo——phpMyAdmin 的左侧面板是服务端渲染，JS 注入时机不可靠
避免使用 WebP 格式：老版本 phpMyAdmin 或 IE/Edge Legacy 不支持
如果企业要求深色模式适配，需额外写媒体查询：@media (prefers-color-scheme: dark)，但 phpMyAdmin 原生不支持，得自己扩展
升级 phpMyAdmin 后，务必验证 logo_left.png 是否被还原，以及自定义主题路径是否仍被识别

最麻烦的其实是路径权限和部署一致性：开发机上 OK 的配置，到生产环境常因 open_basedir、SELinux 或容器挂载限制导致 CSS 不加载——这时候看 PHP 错误日志比猜更有用。