controluser是phpMyAdmin用于执行高级功能（如用户管理、权限变更）的专用数据库账户，需为每个服务器单独创建并授权，且在config.inc.php中为各$cfg['Servers'][$i]显式配置对应controluser和controlpass。
phpMyAdmin多服务器配置中 controluser 是什么
controluser 是 phpmyadmin 用于执行高级功能（如用户管理、权限变更、数据库结构同步）的专用数据库账户，不是你日常操作数据的应用用户。它必须存在且拥有特定权限，否则“用户账户”页里的编辑、删除、刷新权限等按钮会灰掉或报错 cannot proceed: controluser not defined 或 access denied for user 'pma'@'localhost'。
这个账户只在 phpMyAdmin 后台自动调用，不对外暴露，也不用于你的 PHP 应用连接数据库。每个 $cfg['Servers'][$i] 都可以配独立的 controluser 和 controlpass，但前提是该账户在对应 MySQL 实例上真实存在并授了必要权限。
为每个服务器单独创建 controluser 并授权
不能复用同一个 controluser 名称跨服务器使用——MySQL 的 user@host 是唯一标识，pma@localhost 和 pma@192.168.1.100 是两个完全不同的账号。
- 登录目标 MySQL 实例（比如开发机的
localhost:3306），执行：
CREATE USER 'pma_dev'@'localhost' IDENTIFIED BY 'strong-pass-123'; GRANT SELECT, INSERT, UPDATE, DELETE ON `phpmyadmin`.* TO 'pma_dev'@'localhost'; GRANT SELECT ON `mysql`.`db` TO 'pma_dev'@'localhost'; GRANT SELECT ON `mysql`.`user` TO 'pma_dev'@'localhost'; GRANT SELECT ON `mysql`.`tables_priv` TO 'pma_dev'@'localhost'; FLUSH PRIVILEGES;
- 再登录另一台服务器（如 Docker 容器里的
172.18.0.1:3307），执行类似语句，但用户名换为pma_docker，host 换成'172.18.0.1'； - 确保每台服务器上都存在
phpmyadmin数据库（可从 phpMyAdmin 安装包里导入sql/create_tables.sql）； - 不要给
controluser赋予GRANT OPTION或SUPER——它只需要读写 phpmyadmin 系统表和查询 mysql 系统库的几个视图。
config.inc.php 中为各服务器指定不同 controluser
关键点在于：每个 $cfg['Servers'][$i] 块必须显式声明自己的 controluser 和 controlpass，且 $i 必须严格递增、不跳号、不重复。
- 错误写法：
$cfg['Servers'][1]['controluser'] = 'pma'; $cfg['Servers'][2]['controluser'] = 'pma';（同一用户名指向不同 host，但没在 MySQL 侧建对应账号）； - 正确写法（片段）：
$i = 0; $i++; $cfg['Servers'][$i]['host'] = 'localhost'; $cfg['Servers'][$i]['port'] = '3306'; $cfg['Servers'][$i]['controluser'] = 'pma_dev'; $cfg['Servers'][$i]['controlpass'] = 'strong-pass-123'; <p>$i++; $cfg['Servers'][$i]['host'] = '172.18.0.1'; $cfg['Servers'][$i]['port'] = '3307'; $cfg['Servers'][$i]['controluser'] = 'pma_docker'; $cfg['Servers'][$i]['controlpass'] = 'another-strong-pass';
漏掉任意一个 controluser 或密码不匹配，对应服务器的权限管理功能就直接失效，但其他服务器不受影响。
立即学习“PHP免费学习笔记（深入）”；
验证 controluser 是否生效
登录 phpMyAdmin 后，切换到目标服务器 → 点击顶部“用户账户” → 尝试点击任一用户的“编辑权限”。如果页面正常加载、权限复选框可勾选、点“执行”后无报错并成功保存，则说明该服务器的 controluser 已就位。
最容易被忽略的是：本地测试环境用了 root 直连，误以为不需要 controluser；但一旦启用了 cookie 或 http 认证模式，或者想用“用户账户”页批量操作，controluser 就成了硬性依赖。它不像应用用户那样靠代码控制，而是 phpMyAdmin 自身功能运转的底层凭证。
