php数据库怎么进高版本mysql8_php连mysql8兼容法【教程】

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+ 生产环境可用)

即使驱动支持,不显式设置仍可能因默认行为不一致出错:

  • 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.cnfmysqld.cnf,在 [mysqld] 段下添加:default_authentication_plugin=mysql_native_password
  • Docker 启动时传参:--default-authentication-plugin=mysql_native_password
  • 重启 MySQL 后,所有新建用户默认用 mysql_native_password;已有用户仍需手动 ALTER USER,这点常被忽略

真正麻烦的不是“连不上”,而是连上后执行 SELECT 拿到乱码、或 INSERTIncorrect string value —— 这说明 charset 没对齐,比认证问题更隐蔽。务必验证连接后 SHOW VARIABLES LIKE 'character_set%' 和 PHP 端实际发送的编码是否一致。