如何升级现有的phpMyAdmin版本_保留配置文件覆盖升级方案-phpMyAdmin-PHP中文网

升级phpMyAdmin必须停用旧服务、清空浏览器缓存并关闭所有标签页；仅保留config.inc.php，全量替换其余文件；确保PHP版本与扩展兼容，验证登录、建库、SQL执行三大核心功能。

直接覆盖升级前必须停用旧版服务

phpmyadmin 是纯 php 应用，没有后台进程，但浏览器可能缓存旧 js/css 或会话残留导致界面错乱、登录失败甚至配置不生效。覆盖前务必清空浏览器缓存（硬刷新 ctrl+shift+r），并关闭所有已打开的 phpmyadmin 标签页。

常见错误现象：Token mismatch、Cannot start session、左侧导航栏空白、设置项丢失——多数源于旧 JS 文件未更新或 session 存储路径变更后未清理。

确保 Web 服务器（如 Apache/Nginx）已停止对旧目录的访问（可临时重命名旧目录验证）
不要在运行中的 phpMyAdmin 目录里直接解压新包；先移走旧目录，再放新包
若使用 blowfish_secret，它必须保留在新 config.inc.php 中，否则登录页报 Missing parameter: blowfish_secret

只保留 config.inc.php，其他文件全量替换

新版 phpMyAdmin 的结构和依赖（如 vendor/、js/vendor/）经常变动，混用旧 JS 或旧库会导致功能异常（例如：SQL 导入失败、主题切换崩溃、导出格式错乱）。唯一安全保留的是你手动编辑过的 config.inc.php。

使用场景：你改过 $cfg['Servers'][1]['host']、启用了 $cfg['LoginCookieValidity']、加了自定义 $cfg['Servers'][1]['pmadb'] 等配置。

备份原 config.inc.php 到安全位置（如 /tmp/config-backup.php）
解压新版到干净目录后，把备份的 config.inc.php 复制进去，**不要合并内容**
检查新包里的 config.sample.inc.php，对比是否有新增必需配置项（如新版强制要求 $cfg['TempDir']），漏掉会导致“无法上传 SQL 文件”或“导出失败”
权限保持一致：config.inc.php 必须对 Web 用户（如 www-data）不可写，否则 phpMyAdmin 会警告并禁用部分功能

PHP 版本与扩展兼容性必须提前验证

phpMyAdmin 5.2+ 要求 PHP ≥ 7.2.5，5.4+ 要求 PHP ≥ 8.0；若服务器仍跑 PHP 7.1，强行升级会直接白屏，报错 Parse error: syntax error, unexpected token "string"（因使用了 PHP 8 的类型声明语法）。

关键扩展缺失也会静默失败：比如没开 mbstring，搜索中文字段就返回空结果；没开 openssl，连接远程 MySQL 时提示 SSL connection error。

升级前执行 php -v 和 php -m | grep -E 'mbstring|openssl|json|zip'
新版默认启用 $cfg['EnableBLOBUpload'] = true，若 post_max_size 或 upload_max_filesize 过小，大文件导入会卡在进度条 0%
若用 Nginx，确认 fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; 没被注释或覆盖，否则打开页面显示 “No input file specified.”

升级后立即验证三个核心路径

别急着点“导入”或“用户管理”，先用最小动作确认基础链路通了。最容易被忽略的是配置继承是否完整，以及符号链接（如有）是否断开。

访问 /phpmyadmin/index.php，输入账号密码，成功登录即通过第一关
点击右上角“新建”→“数据库”，建一个测试库（如 test_upgrade），能创建说明权限和 MySQL 连接正常
进该库，点“SQL”标签页，执行 SELECT VERSION();，返回结果且无报错，证明查询引擎和字符集处理没崩
若用软链接（如 /var/www/html/phpmyadmin → /opt/phpmyadmin-5.4.2），升级后记得重新指向新目录，否则看似升级了，实际还在跑旧版

复杂点在于：某些定制化配置（如 LDAP 认证、S3 备份插件、自定义主题 CSS）不会随 config.inc.php 自动迁移，它们散落在 libraries/ 或 themes/ 下，得单独比对 diff。这类改动一旦漏掉，上线后才发现“登录方式变了”或“导出按钮没了”，就得回滚。

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