php 8.5 已彻底移除 mysql 扩展,仅支持 mysqli 和 pdo_mysql;二者均默认内置,需通过 php -m 或 phpinfo() 确认启用;连接时须显式设置 utf8mb4 字符集与异常模式,避免乱码和静默失败。

php8.5 没有 mysql 扩展,别再找 mysql_connect 了
PHP 8.5 完全移除了早已废弃的 mysql 扩展(就是那个带 mysql_* 前缀的),连编译都过不去。你搜到的“启用 mysql 扩展”教程,基本都适用于 PHP 5.x,对 8.5 来说不是过时,是无效。
现在唯一官方支持、默认启用的 MySQL 驱动是 mysqli 和 PDO_MySQL。二者都基于 MySQLi C API,但用法和抽象层级不同。
-
mysqli提供面向过程和面向对象两套接口,适合快速迁移老代码或轻量项目 -
PDO_MySQL是 PDO 的 MySQL 具体实现,支持预处理、多数据库切换,更适合新项目或需要抽象层的场景 - 两者在 PHP 8.5 中都默认编译进核心,无需额外安装扩展(除非你用的是极简版 Docker 镜像)
确认 mysqli 或 PDO_MySQL 是否已启用
别凭感觉,直接查。运行 php -m | grep -E 'mysqli|pdo_mysql',或者写个 phpinfo() 页面看模块列表。常见错误现象是:Class 'PDO' not found 或 Call to undefined function mysqli_connect()——这说明扩展没加载,不是代码写错了。
- Linux(apt):确保安装了
php-mysql包(Debian/Ubuntu)或php-mysqlnd(推荐,用 MySQL Native Driver) - macOS(Homebrew):
brew install php@8.5默认包含mysqli和pdo_mysql,但需检查php.ini中是否注释了extension=mysqli和extension=pdo_mysql - Docker:Alpine 镜像常缺扩展,要用
docker-php-ext-install mysqli pdo pdo_mysql显式安装
mysqli 连接 MySQL 的最小可靠写法
别用裸 mysqli_connect() 带一堆参数的老写法,容易漏错误处理。PHP 8.5 对连接失败更严格,不显式判断会直接抛 mysqli_sql_exception(如果启用了异常模式)。
立即学习“PHP免费学习笔记(深入)”;
<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
try {
$db = new mysqli('127.0.0.1', 'user', 'pass', 'dbname', 3306);
$db->set_charset('utf8mb4');
} catch (mysqli_sql_exception $e) {
error_log('MySQL connection failed: ' . $e->getMessage());
die('Service unavailable');
}
?>
- 必须调用
set_charset('utf8mb4'),否则中文可能乱码,尤其存 emoji 时 -
mysqli_report()开启异常模式,比手动检查mysqli_connect_error()更可靠 - 主机名别写
localhost——它在 Linux 下会走 Unix socket,而 Docker 或远程库通常要走 TCP,改用127.0.0.1
PDO_MySQL 初始化时几个硬性参数
PDO 看似简单,但少设一个选项就埋坑。最典型的是字符集和错误模式,PHP 8.5 默认不开启异常,结果 SQL 错误静默失败。
<?php
$options = [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
PDO::MYSQL_ATTR_INIT_COMMAND => "SET NAMES utf8mb4",
PDO::ATTR_EMULATE_PREPARES => false,
];
try {
$pdo = new PDO('mysql:host=127.0.0.1;dbname=dbname;charset=utf8mb4', 'user', 'pass', $options);
} catch (PDOException $e) {
error_log('PDO connection failed: ' . $e->getMessage());
die('DB error');
}
?>
-
charset=utf8mb4要写在 DSN 里,同时配MYSQL_ATTR_INIT_COMMAND是双重保险 -
PDO::ATTR_EMULATE_PREPARES => false强制用 MySQL 原生预处理,避免某些类型(如JSON字段)解析出错 - 别信“PDO 自动处理字符集”,不显式声明 DSN 中的
charset,连接后执行SET NAMES可能被中间件拦截或忽略
复杂点在于:MySQL 服务端配置(如 collation_server)、PHP 连接参数、客户端字段定义三者字符集必须对齐,差一个就丢数据。这个对齐动作没法靠代码全自动搞定,得人工核对。











