应通过浏览器访问 phpinfo() 页面确认真实 PHP 版本，而非仅依赖终端 php -v；需同步检查 Web 服务配置、PHP SAPI 类型、FPM 实例状态及 phpMyAdmin 自身版本兼容性。
phpMyAdmin 报错 “PHP version too low” 怎么快速确认真实版本？
phpmyadmin 显示 php version too low，不等于服务器实际跑的 php 版本真低——更常见的是：web 服务（如 apache 或 nginx）调用的 php 模块版本，和你在终端里执行 php -v 看到的不是同一个。
- 运行
phpinfo()是唯一可信方式：新建一个info.php，内容为<?php phpinfo(); ?>，通过浏览器访问它（不是php -v） - 常见错位场景：系统装了 PHP 8.2，但 Apache 仍加载着旧版
libphp8.0.so；或 Nginx 的fastcgi_pass指向了127.0.0.1:9000，而那边跑的是 PHP-FPM 7.4 实例 - 不要只查
/usr/bin/php，重点看 web 服务配置中明确指定的 PHP SAPI 类型（mod_php、php-fpm、php-cgi）
Apache + mod_php 场景下如何切换 PHP 版本？
Debian/Ubuntu 系统用 a2enmod 切换模块最稳，CentOS/RHEL 需手动改 LoadModule。
- Debian/Ubuntu：
sudo a2dismod php8.0 sudo a2enmod php8.2 sudo systemctl restart apache2
- CentOS/RHEL（Apache 2.4+）：
- 编辑
/etc/httpd/conf.modules.d/15-php.conf - 注释掉旧的
LoadModule php_module modules/libphp-8.0.so - 解注或添加对应新版路径，例如
LoadModule php_module modules/libphp-8.2.so
- 编辑
- 关键检查点：重启后立刻访问
info.php，确认Server API显示Apache 2.0 Handler，且版本号匹配
Nginx + PHP-FPM 升级后页面空白或 502？
Nginx 不直接运行 PHP，只把请求转发给 PHP-FPM。升级 PHP 后，FPM 服务名、socket 路径、用户权限三者极易不一致。
- 常见错误现象：
-
502 Bad Gateway：PHP-FPM 服务没启，或fastcgi_pass指向了不存在的 socket（如从/run/php/php8.0-fpm.sock变成/run/php/php8.2-fpm.sock） - 页面空白无报错：PHP-FPM worker 用户（如
www-data）对新 PHP 二进制或扩展目录无读取权限
-
- 必做动作：
- 确认 PHP-FPM 服务已启用并运行：
sudo systemctl is-active php8.2-fpm - 核对 Nginx 配置中的
fastcgi_pass，路径必须与php8.2-fpm.conf中的listen一致 - 检查
php8.2-fpm.conf的user和group是否和 Nginx worker 一致（通常都是www-data）
- 确认 PHP-FPM 服务已启用并运行：
phpMyAdmin 自身兼容 PHP 8.2+ 的隐藏依赖
即使 PHP 版本达标，phpMyAdmin 5.2.x 以下版本在 PHP 8.2+ 会因废弃函数直接白屏，报错类似 Deprecated: preg_replace(): Passing null to parameter #3 ($subject) of type array|string is deprecated。
- phpMyAdmin 官方支持 PHP 8.2 的最早稳定版是
5.2.1（2022 年 11 月发布），低于此版本一律不建议硬升 PHP - 升级 phpMyAdmin 时不要覆盖
config.inc.php，它的位置通常不在主程序目录内（如 Debian 下在/etc/phpmyadmin/config.inc.php） - 若用包管理器安装（如
apt install phpmyadmin），PHP 版本升级后需重新运行配置向导：sudo dpkg-reconfigure phpmyadmin，否则可能沿用旧的 Apache 模块绑定逻辑
phpMyAdmin 对 PHP 版本的敏感度，远不止“够不够高”，关键在 web 服务链路中每个环节是否真正对齐——尤其是 FPM socket 路径、模块加载顺序、以及它自己代码里有没有偷偷用到被删掉的函数。漏掉其中一环，就只是看着版本数字对了，实际还是报错。
立即学习“PHP免费学习笔记（深入）”；
