推荐用 mod_rewrite 做前端路由映射，前提是启用模块、设置 AllowOverride All、配置正确 RewriteBase，并仅重写非静态资源的入口路径（如 ^(.+)$ → index.php?route=/$1），避免干扰真实文件、POST 接口及 $cfg['PmaAbsoluteUri'] 等硬编码路径。
直接改 phpmyadmin 的访问路径不推荐，但用 mod_rewrite 做前端路由映射是安全可行的——前提是绕过真实文件/目录冲突，且不碰 config.inc.php 中的 $cfg['pmaabsoluteuri'] 等硬编码路径。
确认 mod_rewrite 已启用且允许 .htaccess 覆盖
很多重写失败根本不是规则写错，而是模块没真正生效：
- 运行
apache2ctl -M | grep rewrite（Debian/Ubuntu）或httpd -M | grep rewrite（RHEL/CentOS），必须看到rewrite_module (shared) - 检查对应虚拟主机或目录配置中是否含
AllowOverride All（仅FileInfo也够，但All更少踩坑） - 若用 WAMP/XAMPP，确认菜单里“Apache → Apache Modules → rewrite_module”已勾选
- 重启 Apache 后再测试，
systemctl restart apache2或httpd -k restart
在 phpMyAdmin 根目录放 .htaccess 并设置 RewriteBase
phpMyAdmin 默认不带 .htaccess，你得自己建；RewriteBase 必须匹配其实际 URL 路径，否则重写后资源加载全 404：
- 假设你把
phpMyAdmin放在/var/www/html/pma/，对外访问地址是https://example.com/pma/，则RewriteBase必须写成RewriteBase /pma/ - 如果部署在子域名如
pma.example.com，且文档根就是phpMyAdmin目录，则用RewriteBase / -
RewriteCond %{REQUEST_FILENAME} !-f和!-d必须保留，否则js/、themes/这类真实目录会被错误转发
只重写入口请求，不干扰静态资源和 API 路由
phpMyAdmin 内部大量依赖 index.php + 查询参数（如 index.php?route=/table/structure），不能像框架那样全量重写。安全做法是只接管「无后缀路径」并转给 index.php：
RewriteEngine On
RewriteBase /pma/
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.+)$ index.php?route=/$1 [QSA,L]
- 这条规则只匹配类似
/pma/server/sql这种路径，不会动/pma/js/jquery.js或/pma/themes/pmahomme/css/common.css -
[QSA]保证原始查询参数（如?token=xxx）不丢失 - 不要用
RewriteRule ^.*$ index.php [L]这种暴力写法，它会破坏所有静态资源加载 - 若需隐藏
/pma/前缀（比如想用/db/访问），必须在 Apache 主配置中用Alias+<directory></directory>配合重写，不能只靠.htaccess
避免踩进 phpMyAdmin 自身的路由陷阱
phpMyAdmin 从 5.0 开始默认启用前端路由（index.php?route=...），但它的 PHP 层仍强依赖 $_GET['route'] 解析。重写后若发现白屏或 404，重点查：
立即学习“PHP免费学习笔记（深入）”；
- 浏览器开发者工具 Network 面板里，
index.php?route=...请求是否返回 500？查看响应体是否有Undefined index: route - 确认
phpMyAdmin版本 ≥ 5.0 —— 旧版（如 4.x）压根不识别route参数，强行重写只会 404 - 不要试图重写
/pma/export或/pma/import这类 POST 接口路径，它们不走前端路由，重写后表单提交会失效 - 如果用了自定义
blowfish_secret或auth_type，确保重写不干扰index.php对$_SERVER['REQUEST_URI']的原始解析
最易被忽略的是：重写规则生效后，phpMyAdmin 页面里生成的链接（如顶部导航栏）仍是原始路径，不会自动变成重写后的形式。这意味着你只能用重写“接入”，不能靠它“美化全部链接”——真要彻底隐藏路径，得配合 Nginx 的 location 代理或反向代理方案。
