如何强制浏览器刷新phpMyAdmin主题资源-phpMyAdmin-PHP中文网

Ctrl+R无效因多层缓存拦截，需依次清除浏览器（Ctrl+Shift+R）、PHP OPcache（重启php-fpm）和Web服务器缓存，并验证theme.json的name与compat_version字段、CSS及字体文件路径权限是否正确。

为什么 Ctrl+R 不管用？

因为 phpmyadmin 的主题资源（theme.css、codemirror.css、字体文件等）常被多层缓存拦截：浏览器缓存、php opcache 缓存 config.inc.php、web 服务器（nginx/apache）缓存静态文件，甚至 cdn。单纯按 ctrl+r 只清页面 html，不碰 css 和字体。

必须清掉的三类缓存

缺一不可，顺序不能乱：

浏览器端：用 Ctrl+Shift+R（Windows/Linux）或 Cmd+Shift+R（macOS），禁用所有插件（尤其 Dark Reader 会覆盖 CodeMirror 主题）；无痕窗口验证最可靠
PHP 层：如果改过 config.inc.php（比如 $cfg['ThemeDefault']），OPcache 或 APCu 可能缓存了该文件，执行 sudo systemctl restart php*-fpm（如 php8.2-fpm）
Web 服务器层：Nginx 常配 expires 1y，Apache 可能启用了 mod_expires；临时注释掉相关配置并重载服务（sudo nginx -s reload 或 sudo systemctl reload apache2）

主题资源仍不更新？检查这几个硬性条件

即使缓存全清，主题也可能静默失效：

amphp

使用 AMPHP 框架编写非阻塞异步 PHP 代码，依赖 revolt/event-loop、amphp/amp ^3 及完整 amphp/* 生态（http‑server、http‑client 等）。

下载

themes/your-theme/theme.json 中的 "name" 字段必须与目录名完全一致（大小写、连字符、无空格），例如目录是 dracula，"name" 就只能是 "dracula"
theme.json 中的 "compat_version" 必须严格匹配 phpMyAdmin 主版本号（如 "5.2"），填 "5" 或 "5.2.1" 都会导致主题跳过加载
themes/your-theme/css/theme.css 文件权限需为 644，且 Web 用户（如 www-data）可读；若启用了 $cfg['TempDir']，确保该目录可写，否则 phpMyAdmin 无法动态合并 CSS 资源

快速验证是否生效

别等页面刷新完再猜，直接验证关键路径：

在浏览器地址栏输入 /phpmyadmin/themes/your-theme/css/theme.css，看是否返回 CSS 内容（HTTP 200）
访问 /phpmyadmin/themes/your-theme/fonts/fontawesome-webfont.woff2，确认字体文件可下载（避免图标变方块）
打开开发者工具 → Network → 刷一次页面，筛选 css 和 font 类型，确认新主题的资源请求状态码全是 200，没有 304 或 404

真正卡住人的往往不是“怎么清缓存”，而是清完发现主题目录结构或 theme.json 里一个字段写错，导致整个主题被跳过——它不会报错，只会安静地回退到默认 blue 主题。