如何在phpMyAdmin中为多服务器配置独立的查询历史记录？-phpMyAdmin-PHP中文网

phpMyAdmin多服务器下查询历史默认共享，因其基于浏览器localStorage实现，键名硬编码为pma_query_history，不随服务器切换变化；启用服务端隔离需配置$cfg['QueryHistoryDB']=true、确保各$cfg'Servers'$i指向含pma__history表的数据库。

phpMyAdmin 多服务器下查询历史默认共享的原因

phpmyadmin 的查询历史（query history）默认基于浏览器 localstorage 实现，键名硬编码为 pma_query_history，不随服务器切换变化。这意味着无论你登录的是 localhost 还是 production-db.example.com，只要用的是同一个浏览器、同一个 phpmyadmin 前端实例（比如统一部署在 /phpmyadmin/），所有服务器的查询都会写进同一份 localstorage 记录。

启用 per-server 查询历史的必要配置项

要实现按服务器隔离，必须关闭全局历史并启用服务端存储 + 服务端标识。关键在于两处配置：

$cfg['QueryHistoryDB'] = true;：启用 MySQL 表存储（需先运行 create_tables.sql 创建 pma__history 表）
$cfg['Servers'][$i]['host'] 必须唯一且稳定（不能用 127.0.0.1 和 localhost 混用，否则会被视为不同服务器但实际指向同一实例）
$cfg['Servers'][$i]['pmadb'] 必须统一指向存放 phpMyAdmin 系统表的数据库（例如 phpmyadmin），否则 pma__history 表无法被识别

注意：$cfg['QueryHistoryDB'] 开启后，前端 localStorage 历史自动失效，所有记录走数据库；而 pma__history 表的 username + db + server 三字段联合构成隔离维度——其中 server 字段值来自 $cfg['Servers'][$i]['host']，因此不同服务器的记录天然分开。

常见错误：历史“看似独立”但实际错乱

典型现象是切换服务器后看到别人的查询，或某台服务器历史突然清空。多数由以下原因导致：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

多个服务器共用同一个 $cfg['Servers'][$i]['host'] 值（例如全配成 localhost），导致 pma__history.server 字段值相同，记录混在一起
$cfg['Servers'][$i]['pmadb'] 配置不一致（如一台指 phpmyadmin，另一台指 mysql），造成部分服务器找不到 pma__history 表，退化为 localStorage 模式，又回到共享状态
未执行 create_tables.sql 或权限不足，$cfg['QueryHistoryDB'] = true 实际无效，系统静默回退到 localStorage
浏览器插件（如某些隐私清理工具）定期清空 localStorage，而你误以为这是“多服务器隔离生效”，其实是历史被删了

验证是否真正生效的方法

别只看界面有没有历史条目，直接查数据库最可靠：

SELECT server, db, sqlquery, timevalue 
FROM `phpmyadmin`.`pma__history` 
WHERE username = 'your_login_name' 
ORDER BY timevalue DESC 
LIMIT 10;

检查返回结果中 server 列是否与你当前所选服务器的 $cfg['Servers'][$i]['host'] 完全一致（包括端口，如 db-prod:3307）。如果出现多个不同 server 值混在同一账号下，说明配置已正确；如果全是 localhost 或为空，就该回头核对 config.inc.php 里各 $cfg['Servers'][$i] 块的 host 和 pmadb 设置。

最易被忽略的是：phpMyAdmin 的 server 字段值完全取决于配置文件里的 host，和实际连接时用的 IP、DNS、SSH 隧道无关。哪怕你通过跳板机连内网 DB，只要 host 写的是 internal-db，那历史就归在 internal-db 名下。