PHP连MySQL 8默认失败,因MySQL 8启用caching_sha2_password认证插件,而PHP 7.2及更早版本的mysqlnd驱动不支持;PHP 7.4+需满足OpenSSL启用及驱动编译条件才支持。

PHP 连 MySQL 8 默认会失败,核心原因是 MySQL 8 默认启用 caching_sha2_password 认证插件,而 PHP 7.2 之前版本(含 7.2)的 mysqlnd 驱动不支持它;即使 PHP 7.4+ 支持,也需满足 OpenSSL 和驱动编译条件,否则仍报 Authentication plugin 'caching_sha2_password' cannot be loaded。
确认你的 PHP 版本和 mysqlnd 是否真正支持 caching_sha2_password
别只看 php -v,要查实际使用的驱动细节:
- 运行
php -i | grep "mysqlnd",确认输出中包含mysqlnd 7.4.0 or later(PHP 7.4+ 才内置支持) - 检查
openssl扩展是否已启用:php -m | grep openssl—— 缺失则caching_sha2_password无法解密握手包 - 若用 XAMPP/MAMP/WAMP,它们自带的 PHP 往往是旧编译版,
mysqlnd可能未启用 SHA2 支持,即使版本号够也不行
快速绕过认证问题:改 MySQL 用户认证方式(开发/测试首选)
对本地或测试库,最稳最快的办法不是升级 PHP,而是让 MySQL 8 降级认证方式,兼容老驱动:
- 登录 MySQL 8:
mysql -u root -p - 执行:
ALTER USER 'your_user'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_password'; - 刷新权限:
FLUSH PRIVILEGES; - 注意:不能对
root@localhost直接改(某些安装启用了auth_socket),先确认当前插件:SELECT user,host,plugin FROM mysql.user WHERE user='your_user';
PHP 连接时显式指定 charset 和 auth_plugin(PHP 7.4+ 生产环境可用)
即使驱动支持,不显式设置仍可能因默认行为不一致出错:
立即学习“PHP免费学习笔记(深入)”;
- 用
PDO时,在 DSN 后加;charset=utf8mb4,并确保选项数组包含:PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION - 用
mysqli时,连接后立即执行:$mysqli->set_charset('utf8mb4'); - 如果仍报认证错误,尝试在 DSN 中强制指定旧协议:
mysql:host=localhost;port=3306;charset=utf8mb4(不带ssl参数,除非你真配了有效证书) - 避免使用
mysql_connect()—— 它在 PHP 7.0+ 已被移除,且完全不支持 MySQL 8 认证
docker 或生产环境:MySQL 8 配置文件级兼容(一劳永逸)
如果你控制 MySQL 服务本身(如自建容器或云数据库参数可调),可在启动时统一降级认证方式:
- 修改
my.cnf或mysqld.cnf,在[mysqld]段下添加:default_authentication_plugin=mysql_native_password - Docker 启动时传参:
--default-authentication-plugin=mysql_native_password - 重启 MySQL 后,所有新建用户默认用
mysql_native_password;已有用户仍需手动ALTER USER,这点常被忽略
真正麻烦的不是“连不上”,而是连上后执行 SELECT 拿到乱码、或 INSERT 报 Incorrect string value —— 这说明 charset 没对齐,比认证问题更隐蔽。务必验证连接后 SHOW VARIABLES LIKE 'character_set%' 和 PHP 端实际发送的编码是否一致。











