PHP版本切换后数据库连接失败，大概率因mysqli或pdo_mysql扩展未启用或代码仍调用已移除的mysql_*函数；需检查当前php.ini中扩展是否启用、确认php -m输出含两项、替换废弃函数、改localhost为127.0.0.1测试TCP连接，并用mysqli_connect_error()获取真实错误。
PHP 版本切换后数据库连不上，大概率是 mysqli 或 pdo_mysql 扩展没随版本自动启用，或旧代码调用了已移除的 mysql_* 函数。
确认新 PHP 版本下扩展是否启用
phpEnv 切换版本后，php.ini 文件不会自动继承旧版本的扩展配置，每个 PHP 版本都有独立的 php.ini。常见错误是：新版本 ini 里 extension=mysqli 和 extension=pdo_mysql 被注释或压根不存在。
- 运行
phpenv which php确认当前生效的 PHP 路径，再用php --ini查到它加载的php.ini位置 - 打开该
php.ini，搜索mysqli和pdo_mysql，确保两行未被分号注释，且路径正确（Windows 下为php_mysqli.dll，Linux/macOS 下一般无后缀） - 保存后执行
php -m | grep -E "mysqli|pdo_mysql"，输出应包含两项；若无，说明扩展未加载 - 某些 phpEnv 构建的 PHP 可能默认不编译 mysqli，此时需重新安装该版本：
phpenv install --reinstall x.x.x
检查连接代码是否调用废弃函数
PHP 7.0+ 已彻底移除 mysql_connect()、mysql_query() 等所有 mysql_* 函数。如果旧项目没改过，切到新版后会直接报 Fatal error: Uncaught Error: Call to undefined function mysql_connect()。
- 全局搜索项目中所有
mysql_*调用，包括mysql_pconnect()、mysql_real_escape_string()等 - 必须替换为
mysqli面向对象写法（如new mysqli($host, $user, $pass, $dbname)）或PDO（如new PDO("mysql:host=$host;dbname=$dbname", $user, $pass)） - 注意：
mysqli_connect()是过程式函数，虽可用但不推荐；优先统一改为面向对象风格，避免混用导致资源管理混乱
验证 localhost 解析行为变化
部分 PHP 版本（尤其是较新构建）对 localhost 的处理更严格：默认走 Unix socket，但若 MySQL 实际 socket 路径与 PHP 编译时设定不符，或系统未启用 socket 支持，就会连接失败，错误常为 Connection refused 或超时。
立即学习“PHP免费学习笔记（深入）”；
- 临时改成
127.0.0.1测试：new mysqli('127.0.0.1', $user, $pass, $dbname, 3306)—— 强制走 TCP，绕过 socket 问题 - 若必须用 socket，先查 MySQL 实际路径：
mysqladmin variables | grep socket，再在mysqli构造时显式传入：new mysqli('localhost', $user, $pass, $dbname, 3306, '/var/run/mysqld/mysqld.sock') - 注意：Docker 或容器化环境里，
localhost指容器自身，不是宿主机 MySQL，此时必须用宿主机 IP 或 Docker network 别名
别漏掉扩展依赖和权限细节
扩展启用只是第一步。有些问题藏得更深：比如新 PHP 版本用的是 system OpenSSL，而 MySQL 编译时用的是 LibreSSL，握手失败；或者 SELinux 限制了 PHP 进程访问网络。
- 执行
php -r "var_dump(function_exists('mysqli_connect'));"，输出bool(true)才算函数存在；若为false，说明扩展加载失败，不是代码问题 - Linux 下若启用了 SELinux，运行
setsebool -P httpd_can_network_connect_db 1允许 Web 进程连 DB - phpEnv 默认不开启
display_errors，记得在测试脚本开头加ini_set('display_errors', '1'); error_reporting(E_ALL);，否则错误被静默吞掉 - 连接失败时，务必用
mysqli_connect_error()或$pdo->errorInfo()拿真实错误信息，而不是只看 HTTP 500
