phpEnv 中 phpMyAdmin 升级不可覆盖解压或一键更新，须停用服务、定位至 phpenv\versions\{php-version}\apps\phpmyadmin\ 目录，保留合规 config.inc.php 后全量替换，并确保 PHP ≥ 8.0 及启用 mbstring、openssl 等扩展。
phpEnv 中的 phpMyAdmin 升级不能靠“覆盖解压”或“一键更新”完成，因为 phpEnv 是 Windows 下的多版本 PHP 环境管理工具，其 phpMyAdmin 是作为集成组件嵌入在特定 PHP 版本目录下的，路径固定、权限受限、且与 phpEnv 的服务注册强绑定。直接替换文件极易导致服务无法启动、版本号不更新、甚至 WAMP-style 功能（如右键菜单、托盘控制）失效。
确认 phpEnv 中 phpMyAdmin 的实际安装位置
phpEnv 并未将 phpMyAdmin 放在网站根目录，而是藏在 phpenv\versions\{php-version}\apps\phpmyadmin\ 下（例如 phpenv\versions\8.1.25\apps\phpmyadmin\）。这个路径由 phpEnv 启动脚本硬编码调用，改错位置会导致 404 或空白页。
- 打开 phpEnv 安装目录（如
D:\phpenv），进入对应 PHP 版本子目录的apps\文件夹 - 检查是否存在
phpmyadmin文件夹；若不存在，说明该版本未启用 phpMyAdmin（需手动启用或切换带 phpMyAdmin 的 PHP 版本） - 不要试图在
www\或htdocs\下找它——那些是用户站点目录，和 phpEnv 自带的 phpMyAdmin 无关
升级前必须停用 phpEnv 的 Apache/Nginx 服务
phpEnv 的 Web 服务（通常是 Apache）会锁定 phpMyAdmin 目录中的 index.php 和 session 文件，导致你无法删除旧 JS/CSS/PHP 文件，覆盖后浏览器仍加载缓存资源，出现 Token mismatch 或左侧导航栏空白。
- 点击系统托盘里的 phpEnv 图标 → 选择 “Stop All Services”
- 手动检查任务管理器中是否还有
httpd.exe或nginx.exe进程残留 - 关闭所有已打开的
localhost/phpmyadmin标签页，并执行硬刷新（Ctrl+Shift+R）清空缓存
保留 config.inc.php 后全量替换，但要注意路径兼容性
新版 phpMyAdmin（如 5.2.2+）依赖 vendor/、js/vendor/ 和 templates/ 等结构，混用旧版 JS 会导致 SQL 导入卡死、主题切换崩溃。唯一可安全保留的是你手动改过的 config.inc.php，但它必须满足两个条件：
立即学习“PHP免费学习笔记（深入）”；
-
$cfg['TempDir']必须指向一个真实存在、Web 用户（如 SYSTEM 或 phpEnv 所用账户）有写权限的目录，例如D:\phpenv\temp\phpmyadmin（新版默认不再自动创建） - 若原配置用了
$cfg['Servers'][1]['pmadb']或自定义$cfg['blowfish_secret']，复制时务必确保新config.inc.php中这些行未被注释或覆盖 - 新版要求 PHP ≥ 8.0（5.4.x 起），如果你当前用的是 phpEnv 中的 PHP 7.4，升级 phpMyAdmin 前必须先切换到 PHP 8.0+ 版本，否则打开即报
Parse error: syntax error, unexpected token "string"
验证登录、建库、SQL 执行三大功能，别只看版本号
很多用户看到首页左下角显示 “5.2.1” 就以为升级成功，但实际 Import 按钮点不动、Create database 提交后无响应、或执行 SELECT NOW() 返回空结果——这往往是因为 mbstring 或 openssl 扩展没随新版 PHP 自动启用，而 phpEnv 的 php.ini 是按版本隔离的。
- 进入
phpenv\versions\{new-php-version}\etc\php.ini，确认以下行未被注释：extension=mbstring、extension=openssl、extension=zip - 重启 phpEnv 服务后，访问
localhost/phpmyadmin→ 点击右上角“新建”→ 输入库名提交，观察是否跳转成功 - 进任意数据库 → “SQL” 标签页 → 执行
SELECT 1;，确认返回表格而非空白或错误提示
最容易被忽略的是：phpEnv 的每个 PHP 版本都有独立的 php.ini 和扩展目录，升级 phpMyAdmin 不等于升级了 PHP 扩展支持。没开 mbstring，中文字段搜索就永远为空；没开 openssl，连接远程 MySQL 会卡在 SSL handshake 阶段。这些不会报红字错误，只会静默失败。
