phpMyAdmin 5.1为什么无法保存设计器布局

陌静同学_6289

陌静同学_6289

2026-09-03

300人浏览

原创

直接原因是phpMyAdmin 5.1设计器依赖的phpmyadmin_designer_coords表缺失、结构不匹配、权限不足或字符集冲突,导致INSERT/UPDATE静默失败;需手动导入create_tables.sql、确认表存在且字段完整、检查用户权限及InnoDB引擎与utf8mb4校对一致性。

phpMyAdmin 5.1设计器布局保存失败的直接原因

根本不是设计器本身坏了,而是 phpmyadmin 5.1 的设计器(designer)依赖 phpmyadmin_designer_coords 这张表来持久化布局,而这张表默认不存在,或存在但字段结构不匹配、权限不足、字符集冲突——导致 insert/update 请求静默失败或报错。

常见现象包括:拖动完表位置后点「Save」没反应、刷新页面还原、控制台出现 INSERT INTO `phpmyadmin`.`phpmyadmin_designer_coords` 相关的 403 或 500 错误,或者 MySQL 错误提示 Table 'phpmyadmin.phpmyadmin_designer_coords' doesn't exist。

  • 检查是否已创建 phpmyadmin 系统库:它必须存在且由 phpMyAdmin 自动初始化;若手动删过或用空数据库安装,该库可能缺失
  • 确认 phpmyadmin_designer_coords 表是否存在:执行 SHOW TABLES FROM `phpmyadmin` LIKE 'phpmyadmin_designer_coords';
  • 若表存在,检查字段是否完整:至少需含 db_name、table_name、x、y、v、h 字段;旧版迁移过来的表可能缺 v/h(视图宽高),导致 INSERT 失败
  • 验证当前登录用户对 phpmyadmin 库是否有 INSERT 和 UPDATE 权限——仅 SELECT 不够

为什么新建的 phpmyadmin 库里没有 designer_coords 表?

phpMyAdmin 5.1 不会在首次访问设计器时自动建表,它只在执行 import_create_table.sql 脚本后生成全套系统表。这个脚本通常随安装包提供,但宝塔、Docker 或手动部署时容易遗漏。

标准路径是:/www/server/phpmyadmin/sql/create_tables.sql(宝塔环境)或 ./sql/create_tables.sql(源码安装)。但注意:该文件在 5.1 中默认不自动执行,必须手动导入。

Create PPT with Nano Banana Pro
Create PPT with Nano Banana Pro

使用 Nano Banana Pro 图片和 PptxGenJS 生成带有中文内容的白板式 PPT,专业全幅背景。

下载
  • 用 phpMyAdmin 登录任意数据库 → 选中 phpmyadmin 库 → 「导入」→ 上传 create_tables.sql → 执行
  • 若提示「No database selected」,先确保左上角已切换到 phpmyadmin 库(不是 information_schema 或其他)
  • 导入后检查 phpmyadmin_designer_coords 表的 ENGINE 是否为 InnoDB:MyISAM 在部分 MySQL 8.0+ 环境下已被禁用,会导致 INSERT 失效
  • 别跳过 CREATE DATABASE IF NOT EXISTS `phpmyadmin` CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci; 这句——字符集不一致会引发 Illegal mix of collations,尤其在创建用户或写入设计器坐标时

保存时返回空白或 500,但日志里没明显错误

这通常是 PHP 层面的静默失败:要么 mysqli 执行 INSERT 后没判断结果,要么触发了严格模式下的字段校验(如 x、y 字段被定义为 NOT NULL 但传入空字符串),要么 session 中断导致 token 校验提前失败。

  • 打开 php.ini,确认 display_errors = On 且 error_reporting = E_ALL,然后重现操作,看 PHP 错误日志(如 /var/log/php-fpm/www-error.log)是否有 mysqli_sql_exception 或 Undefined index
  • 检查 phpmyadmin/config.inc.php 中是否误设了 $cfg['Servers'][$i]['controluser']:如果用了控制用户但该用户无权写 phpmyadmin 库,设计器保存会直接失败且无提示
  • 临时在 libraries/classes/Designer.php 的 save() 方法开头加 error_log("designer save called: " . print_r($_POST, true));,确认 POST 数据是否到达服务端
  • 别忽略浏览器 Network 面板里 ajax.php?server=1&ajax_request=1&token=xxx&...&ajax_page=designer 请求的 Response:有时返回 HTML 错误页而非 JSON,说明 PHP fatal error 已发生

设计器坐标保存了,但换浏览器或清缓存后又没了

这不是 bug,是预期行为:phpMyAdmin 5.1 的设计器布局默认按「数据库名 + 表名」维度存储,不绑定用户会话或账号。也就是说,只要 phpmyadmin_designer_coords 表里有对应记录,所有能访问该库的用户都能看到相同布局——但如果你用不同账号登录,或访问的是不同 MySQL 实例(比如本地 vs 远程),就看不到彼此的坐标。

真正容易被忽略的是:设计器坐标只对当前选中的数据库生效。比如你在 test_db 里设计了三张表的布局,切换到 prod_db 后,即使表名一样,也不会复用坐标——因为 db_name 字段值不同。

  • 确认你每次都在同一个数据库上下文里操作设计器(左上角数据库列表是否始终选中目标库)
  • 检查 phpmyadmin_designer_coords 表中 db_name 字段值是否与当前数据库名完全一致(区分大小写,取决于 MySQL 的 lower_case_table_names 设置)
  • 不要指望「全局布局」:phpMyAdmin 5.1 没有跨库共享设计器状态的设计,每个库独立存储
  • 如果需要多人协同维护同一套布局,只能靠定期导出/导入 phpmyadmin_designer_coords 表数据,没有内置同步机制

php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!

相关文章

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2023.09.01

11384

6

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

6601

5

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

2175

5

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

2023.10.23

4168

4

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

2023.10.23

4894

6

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.03

3831

9

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.09

5517

8

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.13

4322

8

sprintf函数用法详解
sprintf函数用法详解

sprintf函数的用法:1、格式化字符串;2、指定输出宽度和精度;3、返回值。更多关于sprintf函数用法详解的内容,大家可以阅读下面的文章。

2023.11.27

12282

4

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习