phpMyAdmin如何配置phpMyAdmin配置存储-phpMyAdmin-PHP中文网

phpmyadmin配置存储是必需功能，用于保存书签、查询历史、表关系等用户状态；需在config.inc.php中配置controluser/controlpass、pmadb及各配置表名，并在mysql中创建专用数据库与用户并授权。

配置存储（configuration storage）不是可选功能，而是让 phpmyadmin 正常保存书签、sql 查询历史、表关系、pdf 导出结构等用户级状态的底层依赖。没启用时，你每次刷新页面都会丢失最近的查询、关系设置或列排序——它不报错，但行为明显“记不住事”。

phpMyAdmin 自带一个 create_tables.sql 脚本，但它只建表，不自动关联到配置。你得手动在 config.inc.php 中声明这些表的位置和权限账户：

$cfg['Servers'][$i]['controluser'] 和 $cfg['Servers'][$i]['controlpass']：必须设为一个**专用的、仅用于配置存储的 MySQL 用户**（不能是 root，也不能复用普通应用账号）
$cfg['Servers'][$i]['pmadb']：指定存放配置表的数据库名，比如 'phpmyadmin'（需提前创建）
$cfg['Servers'][$i]['bookmarktable']、$cfg['Servers'][$i]['relation']、$cfg['Servers'][$i]['table_info'] 等：明确写出每个配置表的表名，不能留空或靠默认值猜
$cfg['Servers'][$i]['column_info'] 和 $cfg['Servers'][$i]['history'] 也必须显式赋值，否则查询历史和字段注释功能直接失效

别直接运行 phpMyAdmin 自带的 sql/create_tables.sql 就完事——它建表但不设权限，且默认用 root@localhost，而你的 controluser 很可能不是 root。正确流程是：

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

下载

先用管理员账号登录 MySQL，执行 CREATE DATABASE IF NOT EXISTS `phpmyadmin` CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
再创建专用用户：CREATE USER 'pma_ctrl'@'localhost' IDENTIFIED BY 'strong_password_here';
只授予必要权限：GRANT SELECT, INSERT, UPDATE, DELETE ON `phpmyadmin`.* TO 'pma_ctrl'@'localhost';
然后导入表结构：mysql -u root -p phpmyadmin
最后确认 controluser 能连上：mysql -u pma_ctrl -p -e "USE phpmyadmin; SHOW TABLES;" ——失败就说明权限或 host 不匹配

最常被忽略的是两个隐性条件：

PHP 的 mysqli 或 PDO 扩展必须启用，且版本兼容（PHP 8.0+ + MySQL 8.0 需确认 caching_sha2_password 插件是否被支持，否则 controluser 连不上）
pmadb 数据库里的所有配置表，其 ENGINE 必须是 InnoDB（不是 MyISAM），否则关系视图和外键约束会静默失效
如果 phpMyAdmin 是通过 Docker 或共享主机部署，config.inc.php 可能被覆盖或读取顺序错乱——检查实际生效的配置文件路径，别只改了本地副本