问题描述
在使用phpmyadmin管理数据库时，如果后端mysql服务器配置了ed25519作为用户认证插件，phpmyadmin可能会因为客户端不支持该认证方法而无法连接，并抛出类似如下的错误信息：
mysqli::real_connect(): The server requested authentication method unknown to the client [client_ed25519] mysqli::real_connect(): (HY000/2054): The server requested authentication method unknown to the client
这表明PHPMyAdmin所依赖的MySQL客户端库无法识别或处理ed25519认证机制。为了解决这一兼容性问题，我们需要调整MySQL服务器的配置，并确保PHPMyAdmin连接的用户使用一种它支持的认证方式，例如mysql_native_password。
解决方案
解决此问题需要两个主要步骤：首先，修改MySQL服务器的配置文件以允许或默认使用mysql_native_password；其次，更新PHPMyAdmin所使用的数据库用户的认证方式。
步骤一：修改MySQL服务器配置文件 (my.cnf)
我们需要编辑MySQL服务器的配置文件，通常位于/etc/mysql/my.cnf或/etc/my.cnf。此修改将允许MySQL服务器提供mysql_native_password作为认证选项。
-
打开配置文件： 使用文本编辑器（如nano或vim）打开MySQL的配置文件。
立即学习“PHP免费学习笔记（深入）”；
sudo nano /etc/mysql/my.cnf
-
添加或修改配置项： 在文件的相应部分添加或修改以下配置。请特别注意[mysqld]部分下的default-authentication-plugin=mysql_native_password，这是解决认证问题的关键。同时，也建议配置字符集以避免潜在的编码问题。
[client] default-character-set=utf8 [mysql] default-character-set=utf8 [mysqld] collation-server = utf8_unicode_ci character-set-server = utf8 default-authentication-plugin=mysql_native_password
- [client]和[mysql]部分设置了客户端连接时的默认字符集为utf8。
- [mysqld]部分是服务器端的配置：
- collation-server = utf8_unicode_ci 和 character-set-server = utf8 确保服务器的默认字符集和排序规则为utf8。
- default-authentication-plugin=mysql_native_password 告诉MySQL服务器，当创建新用户时，默认使用mysql_native_password插件进行认证；或者当客户端未指定特定认证插件时，优先提供此插件。
保存并关闭文件。
-
重启MySQL服务： 配置更改后，必须重启MySQL服务才能使新设置生效。
sudo systemctl restart mysql # 或者对于某些系统 sudo service mysql restart
步骤二：更新数据库用户的认证方法
即使服务器配置了default-authentication-plugin，已存在的用户可能仍然使用ed25519。因此，我们需要明确地将PHPMyAdmin连接所使用的数据库用户的认证方式更改为mysql_native_password。
-
连接到MySQL服务器： 使用支持ed25519认证的客户端（例如，如果您的命令行MySQL客户端支持）或使用具有足够权限的root用户（如果root用户没有使用ed25519）连接到MySQL服务器。
mysql -u root -p
-
执行ALTER USER命令： 在MySQL命令行中，执行以下SQL语句来修改目标用户的认证插件和密码。请将'username'替换为PHPMyAdmin将使用的实际用户名，将'localhost'替换为用户的主机名（例如'%'表示任何主机），并将'password'替换为该用户的新密码。
ALTER USER 'username'@'localhost' IDENTIFIED WITH mysql_native_password BY 'password'; FLUSH PRIVILEGES;
- ALTER USER 'username'@'localhost' 指定了要修改的用户。
- IDENTIFIED WITH mysql_native_password 明确设置该用户使用mysql_native_password认证插件。
- BY 'password' 设置用户的新密码。
- FLUSH PRIVILEGES; 刷新权限表，确保更改立即生效。
退出MySQL命令行。
注意事项与总结
- 安全性考量： ed25519通常被认为是比mysql_native_password更安全的认证方法。将认证方式降级到mysql_native_password是为了解决PHPMyAdmin的兼容性问题。在条件允许的情况下，应考虑升级PHPMyAdmin及其依赖的客户端库，以支持更安全的认证方法，或使用其他支持ed25519的数据库管理工具。
- 用户权限： 执行ALTER USER命令需要CREATE USER或ALTER USER权限。通常，root用户拥有这些权限。
- 配置路径： my.cnf的路径可能因Linux发行版和MySQL安装方式而异。常见的路径包括/etc/mysql/my.cnf、/etc/my.cnf、/var/lib/mysql/my.cnf或/usr/local/mysql/etc/my.cnf。
- 验证连接： 完成上述步骤后，尝试通过PHPMyAdmin连接到MySQL服务器。如果一切配置正确，您应该能够成功登录并管理数据库。
通过以上两个步骤，您应该能够解决PHPMyAdmin因ed25519认证插件而无法连接MySQL服务器的问题，使PHPMyAdmin能够正常工作。请务必在生产环境中进行此类更改前进行充分测试。
