PHP 8 彻底移除 mysql_* 扩展,调用即报 Fatal error;因其自 PHP 5.5 起废弃,缺乏预处理、面向对象接口及安全机制,维护成本过高,且与 JIT 和类型系统不兼容。

PHP 8 彻底移除了 mysql_* 扩展,不是“不推荐”,是直接删了。你项目里只要还留着 mysql_connect()、mysql_query() 这类调用,启动就报 Fatal error: Uncaught Error: Call to undefined function mysql_connect(),没商量余地。
为什么 PHP 8 要砍掉 mysql_* 扩展
这个扩展早在 PHP 5.5.0 就被标记为废弃,2013 年起官方文档就明确说“不要在新项目中使用”。它不支持预处理语句、无面向对象接口、无法复用连接、不能处理多语句——这些在 PHP 8 强化类型和安全模型的背景下,已成硬伤。
移除它不是为了“清理代码”,而是因为维护成本远超价值:没人修 bug,没人写测试,连 CI 都早停掉了。PHP 8 的 JIT 和类型系统优化,也完全绕开了这套 C 层胶水代码。
- PHP 7.4 是最后一个带
mysql_*的版本; - PHP 8.0 开始,
extension=php_mysql.dll(Windows)或extension=mysql.so(Linux)加载直接失败; - 即使你用
dl()动态加载,也会触发Unknown(): Failed to load mysql extension错误。
ThinkPHP 项目里怎么快速定位残留调用
老 TP 项目常在配置文件、自定义 Db 类、钩子行为或第三方插件里偷偷藏着 mysql_*。别只搜 mysql_connect,这些也得查:
-
mysql_pconnect、mysql_fetch_array、mysql_real_escape_string; - 字符串拼接 SQL 时硬编码的
"SELECT * FROM table WHERE id = " . $id(说明没走预处理,大概率底层还是 mysql_*); - config/database.php 中
'type' => 'mysql'却没配'pdo' => true,这种配置在 PHP 8 下会 fallback 到已删除驱动,报错前不提示。
实操命令:grep -r "mysql_[a-z]" app/ extend/ config/ --include="*.php",再加 | grep -v "vendor/" 排除干扰。
替换时最容易踩的坑:mysqli_connect() 不等于 mysql_connect()
mysqli_connect() 看似只是多了个 i,但参数顺序、错误处理、连接复用逻辑全变了:
-
mysql_connect($host, $user, $pass)→mysqli_connect($host, $user, $pass, $dbname, $port, $socket),第 4 个参数是库名,不是可选的; -
mysql_query()返回 resource,mysqli_query()默认返回mysqli_result对象,直接count()会报TypeError; - 旧代码里
@mysql_query()的抑制符在 PHP 8 对致命错误无效,该崩还是崩。
更稳妥的做法是统一切到 PDO:new PDO('mysql:host=localhost;dbname=test', $user, $pass),它抽象层更干净,预处理语法一致,且 TP5.1+ 原生支持。
第三方扩展包还在用 mysql_* 怎么办
比如 topthink/think-captcha 或某些老版支付 SDK,composer.json 里写着 "php": ">=5.6.0",PHP 8 下照样装得进去,运行时才暴露问题。
别急着 fork 改源码。先确认是否真被调用:在入口加 function mysql_connect() { throw new Error('mysql_connect called'); },跑一遍流程看哪行崩;如果只是 vendor 里有但没执行,可暂时用 composer require --dev phpstan/phpstan 扫描,配合 --level 7 检出所有废弃函数引用。
真正难搞的是那些把 mysql_* 编进二进制扩展(.so/.dll)的包——这类只能换方案,没有兼容补丁。
最麻烦的不是改几行代码,而是有些老项目把 mysql_* 当作“数据访问层”来用,满屏 mysql_query("INSERT INTO ...")。这种场景下,光替换函数名没用,得重写 SQL 组装逻辑,确保绑定参数、处理异常、关闭连接都符合现代规范。别想着“先跑起来再说”,PHP 8 的错误机制不会给你模糊地带。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











