PHP5.2老项目迁移至PHP7.1时mysql转mysqli出现代码错误求助
适配报错核心原因
- PHP7.1 已完全移除原生 mysql 扩展,直接做函数名替换时,忽略了 mysqli 扩展的两个核心特性:
- 所有涉及连接操作的方法,必须显式传入提前建立的数据库连接实例,不再默认使用全局隐式连接
- 过程式写法下,需要连接实例的函数,参数顺序与老 mysql 扩展完全相反
零业务侵入的兼容改造方案
第一步先替换原有数据库初始化逻辑,建立全局可用的 mysqli 连接:
// 替换原mysql_connect初始化代码 $globalMysqliConn = mysqli_connect(DB_HOST, DB_USER, DB_PASS, DB_NAME); if (! $globalMysqliConn) { die("数据库连接失败:" . mysqli_connect_error()); } // 对齐老项目的字符集配置,避免升级后乱码 mysqli_set_charset($globalMysqliConn, DB_CHARSET);
第二步逐一对原封装函数做适配,完全保留原有函数名、入参、返回值逻辑,上层业务代码无需改动:
- 改造
queryRunner:对齐执行查询、错误终止、返回结果集的原有逻辑
注意:mysqli_query 必须将连接实例作为第一个参数、SQL 语句作为第二个参数,和老 mysql_query 的参数顺序完全相反,是替换后最高发的报错点function queryRunner($query){ global $globalMysqliConn; $result = mysqli_query($globalMysqliConn, $query); if (! $result) { die(mysqli_error($globalMysqliConn)); } return $result; } - 改造
countRow:直接替换函数名即可,逻辑与老实现完全一致function countRow($result){ return mysqli_num_rows($result); } - 改造
rowRetriever:直接替换函数名即可,逻辑与老实现完全一致function rowRetriever($result){ return mysqli_fetch_assoc($result); } - 改造
rowRetrieverObject:直接替换函数名即可,逻辑与老实现完全一致function rowRetrieverObject($result){ return mysqli_fetch_object($result); } - 改造
findLastInsertId:补充连接实例参数,对齐获取最后插入自增ID的逻辑
注意:mysqli_insert_id 必须传入连接实例才能获取正确值,缺失该参数会返回0或者触发错误function findLastInsertId(){ global $globalMysqliConn; return mysqli_insert_id($globalMysqliConn); } - 改造
simplifySpecialCharacter:补充连接实例参数、对齐参数顺序,匹配原有转义逻辑
注意:mysqli_real_escape_string 参数顺序与老 mysql_real_escape_string 完全相反,第一个参数必须是连接实例,第二个才是待转义的字符串,缺失连接、顺序颠倒都会触发报错function simplifySpecialCharacter($data){ global $globalMysqliConn; return mysqli_real_escape_string($globalMysqliConn, $data); }
上线前校验要点
- 逐一验证核心流程:常规查询执行、结果集行数统计、关联数组/对象形式取数、插入数据后获取自增ID、特殊字符转义效果
- 确认连接字符集与老项目配置完全一致,避免升级后出现中文乱码
- 可在封装层后续逐步叠加预处理语句能力,无需一次性重构全部业务代码
内容的提问来源于stack exchange,提问作者Shivendra Kr. Sahu
相关产品推荐
相关产品推荐

