phpMyAdmin 5.2+ 中需在 config.inc.php 中设置 $cfg['ShowQBE'] = false; 才能禁用“跨表查询向导”图标,该配置为服务端全局开关,不支持用户偏好或界面操作关闭,升级后需检查是否被重置。

phpMyAdmin 5.2+ 版本中如何禁用“跨表查询向导”图标
从 phpMyAdmin 5.2 开始,Query by example (QBE) 功能(即“跨表查询向导”)默认启用并显示在数据库/表页面顶部工具栏,但实际使用率低,且容易和 SQL 标签页混淆。它不能通过界面开关关闭,必须修改配置。
核心操作是编辑 config.inc.php,添加或修改 $cfg['ShowQBE'] 配置项:
-
$cfg['ShowQBE'] = false;—— 完全隐藏该图标(推荐) - 该配置需放在
$cfg['Servers']数组定义之后、?>之前 - 若使用多服务器配置,它对所有服务器生效;不支持按单个服务器开关
- 修改后需刷新浏览器(无需重启 Web 服务),但部分旧缓存可能需硬刷新(
Ctrl+Shift+R)
为什么不能在用户偏好里关掉 QBE 图标
phpMyAdmin 的「用户偏好设置」(User preferences)只控制界面主题、字体、SQL 提示等客户端行为,ShowQBE 是服务端功能开关,属于全局配置层级。尝试在「设置 → 个性化」里找对应选项会失败,因为根本不存在这个 UI 控件。
常见误操作包括:
立即学习“PHP免费学习笔记(深入)”;
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
- 在「常规设置」里勾选/取消「显示 SQL 查询框」——这影响的是
SQL标签页,和 QBE 图标无关 - 清空「导航面板」自定义项目——QBE 图标不在可拖拽列表中,无法移除
- 用浏览器插件隐藏 DOM 元素——临时有效,但每次更新 phpMyAdmin 后按钮可能重新出现或位置变动
隐藏 QBE 后,还能手动访问跨表查询功能吗
可以,但路径变深:进入任意数据库 → 点击顶部 SQL 标签页 → 在 SQL 编辑器下方点击 Query by example 链接(小字,常被忽略)。这个链接始终存在,只是不再以醒目的图标形式暴露。
这意味着:
- 日常简单查询更清爽,尤其适合给非 DBA 用户使用的环境
- 高级用户仍保有入口,只是需要多点一次,符合「默认隐藏、按需展开」的设计逻辑
- 不会影响
JOIN语句执行能力,也不改变任何 SQL 解析行为
升级 phpMyAdmin 后 QBE 图标又出现了怎么办
这是最常被忽略的点:升级时若覆盖了 config.inc.php(比如用一键包重装),你的 $cfg['ShowQBE'] = false; 会被重置为默认值 true。不要假设配置会自动继承。
应对方式很简单:
- 升级前先备份
config.inc.php - 升级后检查该文件是否被替换;如果是,把备份里的
ShowQBE行补回去 - 注意某些 Docker 镜像(如
phpmyadmin/phpmyadmin)默认不挂载配置文件,需显式映射/etc/phpmyadmin/config.user.inc.php并在里面写配置
真正的简化不是靠视觉隐藏,而是让配置在升级周期里保持稳定。否则每次更新都得重新找一遍入口。


















