0

0

PHP版本升级后数据库连接失败怎么办_常见故障排查与修复【教程】

星夢妙者

星夢妙者

发布时间:2026-02-17 16:51:09

|

512人浏览过

|

来源于php中文网

原创

php升级后数据库连接失败,主因是mysql扩展被移除及配置变更;需启用mysqli/pdo_mysql扩展、重写连接代码、调整socket/tls设置、校验php.ini中mysql相关参数。

php版本升级后数据库连接失败怎么办_常见故障排查与修复【教程】

PHP版本升级后数据库连接失败,通常是因为新版本PHP移除了旧版中默认启用的扩展(如mysql扩展),或更改了配置参数的默认值。以下是针对此问题的多种排查与修复方法:

一、检查并启用正确的数据库扩展

PHP 7.0 及以上版本已完全移除 mysql_* 函数和 mysql 扩展,仅支持 mysqli 和 pdo_mysql 扩展。若代码仍调用 mysql_connect() 等函数,将直接报错;即使使用 mysqli,若扩展未启用,也会导致连接失败。

1、打开 php.ini 文件,定位到扩展加载区域。

2、确认以下行未被注释且路径正确:extension=mysqli(Windows 下为 extension=php_mysqli.dll)。

立即学习PHP免费学习笔记(深入)”;

3、同时检查是否启用了 PDO 支持:extension=pdo_mysql(Windows 下为 extension=php_pdo_mysql.dll)。

4、保存 php.ini 文件,重启 Web 服务器(如 Apache 或 Nginx)。

5、创建一个 test.php 文件,内容为 ,访问该页面,搜索 “mysqli” 和 “pdo_mysql”,确认其状态为 “enabled”。

二、更新数据库连接代码以兼容新 PHP 版本

若原代码使用已废弃的 mysql_* 函数,必须重写为 mysqli 或 PDO 风格。直接替换可避免因函数不存在导致的致命错误。

1、将 mysql_connect($host, $user, $pass) 替换为 $conn = new mysqli($host, $user, $pass, $dbname);

2、将 mysql_select_db($dbname, $conn) 删除,因其在 mysqli 构造函数中已指定数据库名。

3、将 mysql_query($sql, $conn) 替换为 $conn->query($sql)

4、检查所有 mysql_* 调用,逐一替换为对应 mysqli 面向对象方式;若使用 PDO,则统一改用 $pdo = new PDO("mysql:host=$host;dbname=$dbname", $user, $pass);

Synthesys
Synthesys

Synthesys是一家领先的AI虚拟媒体平台,用户只需点击几下鼠标就可以制作专业的AI画外音和AI视频

下载

三、验证 MySQLi 默认端口与 socket 设置

PHP 升级后,mysqli 扩展可能不再自动回退到 /tmp/mysql.sock,或对 localhost 解析行为变化(部分版本将 localhost 视为 TCP 连接而非 Unix socket),导致连接超时或拒绝。

1、在连接代码中显式指定 host 为 127.0.0.1 而非 localhost,强制走 TCP 协议。

2、若需使用 Unix socket,构造 mysqli 实例时传入 socket 参数:$conn = new mysqli('localhost', $user, $pass, $dbname, 3306, '/var/run/mysqld/mysqld.sock');

3、通过命令行执行 mysqladmin variables | grep socket 查看 MySQL 实际 socket 路径,并确保 PHP 中路径一致。

四、检查 OpenSSL 与 TLS 协议兼容性

PHP 7.4+ 默认启用更严格的 TLS 版本要求(如最低 TLS 1.2),若 MySQL 服务器仅支持 TLS 1.0 或未配置有效证书,mysqli 或 PDO 连接会静默失败或抛出 SSL 相关警告。

1、在 php.ini 中临时禁用 SSL 验证测试(仅限调试):mysqli.default_socket=/var/run/mysqld/mysqld.sock 并添加 mysqli.ssl_ca=mysqli.ssl_cert=mysqli.ssl_key= 为空值。

2、在 mysqli 连接后立即调用 $conn->options(MYSQLI_OPT_SSL_VERIFY_SERVER_CERT, false);(注意:仅用于排查,不可用于生产)。

3、登录 MySQL 服务器执行 SHOW VARIABLES LIKE 'have_ssl';SELECT @@tls_version;,确认服务端 TLS 支持状态。

五、校验 php.ini 中 MySQL 相关配置项变更

新版 PHP 修改了若干 MySQL 默认行为参数,例如 mysql.default_port 不再影响 mysqli,而 mysqli.default_port 成为独立控制项;部分发行版还默认关闭了 persistent 连接。

1、在 php.ini 中查找 mysqli.default_port,确认其值为 3306(或与 MySQL 实际端口一致)。

2、检查是否存在 mysqli.allow_persistent = Off,若应用依赖持久连接,需设为 On 并确认 mysqli.max_persistent 数值足够。

3、确认 mysqli.reconnect = On 已启用,防止因连接中断后未自动重连导致后续查询失败。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
数据分析工具有哪些
数据分析工具有哪些

数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍:1、Excel,具有强大的计算和数据处理功能;2、SQL,可以进行数据查询、过滤、排序、聚合等操作;3、Python,拥有丰富的数据分析库;4、R,拥有丰富的统计分析库和图形库;5、Tableau,提供了直观易用的用户界面等等。

965

2023.10.12

SQL中distinct的用法
SQL中distinct的用法

SQL中distinct的语法是“SELECT DISTINCT column1, column2,...,FROM table_name;”。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

334

2023.10.27

SQL中months_between使用方法
SQL中months_between使用方法

在SQL中,MONTHS_BETWEEN 是一个常见的函数,用于计算两个日期之间的月份差。想了解更多SQL的相关内容,可以阅读本专题下面的文章。

377

2024.02.23

SQL出现5120错误解决方法
SQL出现5120错误解决方法

SQL Server错误5120是由于没有足够的权限来访问或操作指定的数据库或文件引起的。想了解更多sql错误的相关内容,可以阅读本专题下面的文章。

1696

2024.03.06

sql procedure语法错误解决方法
sql procedure语法错误解决方法

sql procedure语法错误解决办法:1、仔细检查错误消息;2、检查语法规则;3、检查括号和引号;4、检查变量和参数;5、检查关键字和函数;6、逐步调试;7、参考文档和示例。想了解更多语法错误的相关内容,可以阅读本专题下面的文章。

371

2024.03.06

oracle数据库运行sql方法
oracle数据库运行sql方法

运行sql步骤包括:打开sql plus工具并连接到数据库。在提示符下输入sql语句。按enter键运行该语句。查看结果,错误消息或退出sql plus。想了解更多oracle数据库的相关内容,可以阅读本专题下面的文章。

1252

2024.04.07

sql中where的含义
sql中where的含义

sql中where子句用于从表中过滤数据,它基于指定条件选择特定的行。想了解更多where的相关内容,可以阅读本专题下面的文章。

585

2024.04.29

sql中删除表的语句是什么
sql中删除表的语句是什么

sql中用于删除表的语句是drop table。语法为drop table table_name;该语句将永久删除指定表的表和数据。想了解更多sql的相关内容,可以阅读本专题下面的文章。

436

2024.04.29

pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法
pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法

本专题系统整理pixiv网页版官网入口及登录访问方式,涵盖官网登录页面直达路径、在线阅读入口及快速进入方法说明,帮助用户高效找到pixiv官方网站,实现便捷、安全的网页端浏览与账号登录体验。

283

2026.02.13

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 12万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 11.2万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 0.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号