phpMyAdmin 7.0+ 登录页右上角 Logo 实际路径为 ./themes/pmahomme/img/logo_right.png,须为带 Alpha 通道的 PNG 格式、建议 ≤50×50 像素;背景图需通过 login.css 中相对 CSS 文件路径的 url() 设置,且应避免直接修改 vendor 目录以防升级丢失。

修改 phpMyAdmin 登录页 Logo 图标的实际路径和文件格式要求
phpMyAdmin 7.0+ 版本默认从 ./themes/pmahomme/img/logo_right.png 加载登录页右上角 Logo(即“phpMyAdmin”文字右侧那个小图标),不是 logo_left.png 或 CSS 背景。替换前必须确认你用的是默认主题 pmahomme,且文件是 PNG 格式、尺寸建议保持 50×50 像素以内——过大或非透明背景会导致显示错位或遮挡文字。
操作步骤:
- 备份原图:
cp ./themes/pmahomme/img/logo_right.png ./themes/pmahomme/img/logo_right.png.bak - 准备你的新图标:导出为 32-bit PNG(含 alpha 通道),命名仍为
logo_right.png - 覆盖上传:
cp your-logo.png ./themes/pmahomme/img/logo_right.png - 清空浏览器缓存,或强制刷新(
Ctrl+F5),否则可能仍加载旧缓存版本
替换登录页背景图需改 CSS 并注意路径作用域
登录页背景由 ./themes/pmahomme/css/login.css 中的 .login-page 类控制,但关键点在于:该 CSS 文件里的 URL 路径是相对于 CSS 文件自身位置解析的,不是相对于网站根目录。所以不能写 url(/images/bg.jpg),而要写相对路径如 url(../../images/bg.jpg)(假设你把图放在 ./images/bg.jpg)。
常见错误现象:
立即学习“PHP免费学习笔记(深入)”;
- 背景不显示 → 检查浏览器开发者工具 Network 面板,看
bg.jpg是否返回 404; - 背景只在部分分辨率生效 → 原 CSS 使用了
background-size: cover+background-attachment: fixed,若图太小会拉伸失真,建议用至少 1920×1080 的 JPG/PNG; - 登录框文字看不清 → 在
login.css中给.login-form增加background: rgba(255, 255, 255, 0.92);提升可读性
避免被升级覆盖:不要直接改 vendor 目录下的文件
如果你是用 Composer 安装的 phpMyAdmin(比如通过 composer create-project phpmyadmin/phpmyadmin),那么 ./themes/ 实际位于 ./vendor/phpmyadmin/phpmyadmin/themes/。直接修改这里,下次运行 composer update 会彻底丢失所有定制。
安全做法是:
- 复制整个
pmahomme主题到./custom-themes/pmahomme(与./themes/同级); - 修改
./config.inc.php,添加:$cfg['ThemePath'] = './custom-themes';; - 重启 Web 服务后,phpMyAdmin 会优先从
./custom-themes/加载,升级时不受影响
登录页 HTML 结构不可直接修改,CSS 是唯一可控入口
phpMyAdmin 登录页(./index.php)的 HTML 是硬编码生成的,没有模板文件可编辑。你无法增删 <img> 标签或改 class 名——所有视觉定制只能靠覆盖 CSS 和替换指定路径下的静态资源。例如想隐藏左上角文字 logo,只能加这条 CSS:
body.login-page .logo a { display: none !important; }
或者想微调登录框位置,用 .login-form { margin-top: 40px; }。记住:任何改动都必须放在你控制的 CSS 文件里(如 custom-themes/pmahomme/css/login.css),并确保它被正确加载(检查浏览器 Elements 面板中 <link> 标签是否指向你改的路径)。
最易被忽略的是权限问题:Web 服务器用户(如 www-data)必须对新图片和 CSS 文件有读取权限,否则 403 错误静默发生,浏览器只显示空白背景或默认图标。



















