phpMyAdmin 5.2 的高级功能需启用 ConfigurationStorage，依赖独立的 controluser（如 'pma'@'localhost'）而非 root 或普通用户，该账号仅对 phpmyadmin 库中指定的 pma__ 开头的 10 张表拥有 SELECT/INSERT/UPDATE/DELETE 权限，且必须在 config.inc.php 中正确定义 pmadb、controluser、controlpass 及各功能表名，授权后执行 FLUSH PRIVILEGES 并验证关系视图、书签保存和功能页提示是否正常。
phpMyAdmin 5.2 的“控制台高级功能”（如查询历史、书签、关系视图、字段注释等）不是开箱即用的，必须启用并正确配置 ConfigurationStorage（配置存储），且依赖一个专用的控制用户（controluser）——它和你登录 MySQL 的账号无关，是 phpMyAdmin 内部用来读写自身管理表的独立账户。
为什么 controluser 不是 root 或普通数据库用户？
phpMyAdmin 需要持久化保存用户级元数据（比如你在“结构”页设的外键关系、在“SQL”页存的书签），这些不能存在 session 或本地 storage 里。它必须写入 MySQL 的某张表，但又不能让每个终端用户都拥有 ALTER/INSERT 权限去改这些系统表。所以引入 controluser：一个权限受限、只对 phpMyAdmin 自己的 pmadb 数据库操作的代理账号。
-
controluser必须能SELECT, INSERT, UPDATE, DELETE指定的 10 张配置表（如pma__bookmark、pma__relation），但不能有DROP或跨库权限 - 它和
$cfg['Servers'][$i]['user']完全分离；后者是你登录时填的账号，前者是 phpMyAdmin 后台静默使用的账号 - 如果误把 root 当作
controluser，会导致安全风险；如果权限太小（比如只给了 SELECT），则“关系”“书签”等功能灰显或报错 #1044
创建 controluser 并授权的最小必要步骤
别直接用 GRANT ALL，也别跳过 CREATE USER 直接 GRANT —— MySQL 8.0+ 会拒绝。以下命令需在 MySQL 命令行中执行：
CREATE USER 'pma'@'localhost' IDENTIFIED BY 'strong-password-here'; CREATE DATABASE IF NOT EXISTS `phpmyadmin`; GRANT SELECT, INSERT, UPDATE, DELETE ON `phpmyadmin`.* TO 'pma'@'localhost';
-
'pma'@'localhost'中的localhost必须和 phpMyAdmin 所在服务器访问 MySQL 的 host 一致（若 phpMyAdmin 跑在 Docker 容器里，可能是'pma'@'%'，但需额外确认网络可达性） - 数据库名
phpmyadmin可自定义，但后续$cfg['Servers'][$i]['pmadb']必须严格匹配 - 授权后务必执行
FLUSH PRIVILEGES;，否则权限不生效
config.inc.php 中必须设置的 5 个键值
仅创建用户还不够。phpMyAdmin 必须知道该用谁、连哪库、查哪些表。这 5 行缺一不可，且必须放在 $cfg['Servers'][$i] 数组内（$i 是服务器索引，通常为 0 或 1）：
立即学习“PHP免费学习笔记（深入）”；
-
$cfg['Servers'][$i]['pmadb'] = 'phpmyadmin';—— 和上一步建的库名一致 -
$cfg['Servers'][$i]['controluser'] = 'pma';—— 和CREATE USER的用户名一致 -
$cfg['Servers'][$i]['controlpass'] = 'strong-password-here';—— 明文密码，PHP 进程内使用，确保文件权限为600 -
$cfg['Servers'][$i]['bookmarktable'] = 'pma__bookmark';—— 表名必须带前缀pma__，且与实际建表名完全一致 -
$cfg['Servers'][$i]['relation'] = 'pma__relation';—— 同上，其他表如pma__table_info、pma__pdf_pages等也要按需声明
注意：pma__ 是默认前缀，如果你用 setup 页面生成表结构，它会自动加这个前缀；手动建表时别漏掉下划线。
验证是否生效：三个立刻可见的信号
改完配置、重启 Web 服务后，不用跑 SQL，直接看界面反应：
- 打开任意数据表的“结构”页，右上角出现“关系视图”链接 → 说明
relation表已识别 - 进入“SQL”页，底部出现“保存”按钮（可存为书签）→ 说明
bookmarktable可写 - 访问“设置”→“功能”，页面顶部显示绿色提示 “Configuration storage is enabled” → 说明
pmadb和controluser连通正常
如果只满足其中一两条，大概率是某张表缺失、权限未刷、或 config.inc.php 里某个表名拼错了字母——尤其注意双下划线 pma__bookmark 不是 pma_bookmark 或 pma_ bookmark。
