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 -v,要查实际使用的驱动细节:
php -i | grep "mysqlnd",确认输出中包含 mysqlnd 7.4.0 or later(PHP 7.4+ 才内置支持)openssl 扩展是否已启用:php -m | grep openssl —— 缺失则 caching_sha2_password 无
mysqlnd 可能未启用 SHA2 支持,即使版本号够也不行对本地或测试库,最稳最快的办法不是升级 PHP,而是让 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';
即使驱动支持,不显式设置仍可能因默认行为不一致出错:
PDO 时,在 DSN 后加 ;charset=utf8mb4,并确保选项数组包含:PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION
mysqli 时,连接后立即执行:$mysqli->set_charset('utf8mb4');
mysql:host=localhost;port=3306;charset=utf8mb4(不带 ssl 参数,除非你真配了有效证书)mysql_connect() —— 它在 PHP 7.0+ 已被移除,且完全不支持 MySQL 8 认证如果你控制 MySQL 服务本身(如自建容器或云数据库参数可调),可在启动时统一降级认证方式:
my.cnf 或 mysqld.cnf,在 [mysqld] 段下添加:default_authentication_plugin=mysql_native_password
--default-authentication-plugin=mysql_native_password
mysql_native_password;已有用户仍需手动 ALTER USER,这点常被忽略真正麻烦的不是“连不上”,而是连上后执行 SELECT 拿到乱码、或 INSERT 报 Incorrect string value —— 这说明 charset 没对齐,比认证问题更隐蔽。务必验证连接后 SHOW VARIABLES LIKE 'character_set%' 和 PHP 端实际发送的编码是否一致。