phpMyAdmin 5.0+ 登录页不可直接修改templates/login.twig，因其模板已编译为PHP类并缓存，硬改源文件无效；唯一稳定定制方式是通过$cfg['LoginHeader']注入CSS或重写LoginController.php，升级后所有文件修改均会丢失。
直接改模板文件能重构登录页，但 phpMyAdmin 5.0+ 已弃用传统 templates/ 目录结构，硬改会失效或被升级覆盖。
确认你的 phpMyAdmin 版本和模板机制
phpMyAdmin 4.9 及更早版本使用 Twig 模板，但存放在 templates/ 下且可直接编辑；5.0 起模板被编译进 PHP 类，templates/ 目录仅作源码参考，实际渲染由 PMA\Template 类驱动，修改文件系统中的 .twig 文件无效。
- 运行
SELECT @@version;或查看 phpMyAdmin 底部页脚确认版本 - 检查
vendor/twig/twig/是否存在 —— 存在说明是 Twig 渲染，但路径不等于可编辑 - 打开登录页源码，搜索
login.twig—— 若没找到对应注释或加载痕迹，基本确定模板已静态化或被覆盖
真正生效的登录页定制方式（5.0+）
官方不提供登录页主题接口，唯一稳定路径是通过 $cfg['LoginCookieValidity'] 等配置间接影响行为，或用前端注入方式补丁式修改。强行改布局必须走以下两条路：
-
方案 A（推荐）：用
config.inc.php注入自定义 CSS/JS 在$cfg['Servers'][$i]['auth_type'] = 'cookie';后添加：$cfg['LoginHeader'] = '<style>#login_form { max-width: 500px; margin: 40px auto; } .logo { display: none; }</style>';注意：LoginHeader仅支持 HTML 片段，不能执行 JS；CSS 选择器需兼容实际 DOM（如新版登录表单 ID 是login_form，不是loginForm） -
方案 B（高风险）：重写
libraries/classes/Controllers/LoginController.php找到renderLogin()方法，修改其调用的$this->template->render('login')行，传入额外变量（如['custom_logo' => '/img/my-logo.svg']），再配合自定义 Twig 模板（需启用开发模式并重建缓存）
为什么直接改 templates/login.twig 没用？
因为 phpMyAdmin 启动时会将 Twig 模板编译为 PHP 类并缓存到 tmp/templates_c/，运行时加载的是编译后代码。你改的源文件只是开发副本，除非手动清空缓存并禁用模板缓存（设 define('PMA_IS_DEVELOPMENT', true);），否则改动不会生效。
立即学习“PHP免费学习笔记（深入）”；
- 缓存路径取决于
$cfg['TempDir']配置，默认可能是/var/lib/phpmyadmin/tmp/ - 即使清缓存，升级 phpMyAdmin 时
templates/目录会被覆盖，所有修改丢失 - 新版中部分 HTML 已硬编码在控制器里（如错误提示框逻辑），Twig 模板只负责骨架，无法控制全部结构
真要深度定制登录页，得接受它不是“模板驱动”而是“控制器+有限模板+运行时注入”混合体——最稳的其实是用 Nginx/Apache 的 sub_filter 替换响应 HTML，或者把 phpMyAdmin 套在自有登录页后做反向代理鉴权。
