phpEnv环境中解决“Access denied for user”报错-php教程-PHP中文网

mysql中localhost与127.0.0.1本质不同：localhost强制走unix socket连接，仅匹配'user'@'localhost'权限；127.0.0.1强制走tcp/ip，匹配'user'@'127.0.0.1'或'%'.

phpenv环境中解决“access denied for user”报错

确认 PHP 连接时实际使用的 host 是 localhost 还是 127.0.0.1

phpEnv 默认用 localhost 作为 DB_HOST，但 MySQL 对它的处理很特殊：它会走 Unix socket 而非 TCP，因此只匹配 'user'@'localhost' 这条权限记录，'user'@'%' 或 'user'@'127.0.0.1' 完全无效。你改了 'user'@'%' 的密码和权限，却仍报错，大概率是因为 PHP 实际连的是 socket 地址。

验证方式很简单：在 phpEnv 的 PHP 脚本里加一行：

var_dump($_SERVER['SERVER_ADDR'] ?? 'unknown');

再看 MySQL 里执行 SELECT USER(), CURRENT_USER(); 的输出——如果前者是 root@localhost 而后者是 root@127.0.0.1，说明权限没对上。

临时绕过：把 DB_HOST 改成 127.0.0.1（强制走 TCP），再建对应权限
长期建议：统一用 127.0.0.1，避免 socket 行为差异干扰部署
别信“localhost 和 127.0.0.1 等价”——MySQL 权限系统里它们就是两个用户

检查 MySQL 用户是否真被创建在 localhost host 上

phpEnv 自带的 MySQL（尤其是集成版如 phpStudy、phpEnv Pro）常默认启用 skip-grant-tables 或预置 root 用户，但权限记录可能不完整。错误信息里 Access denied for user 'root'@'localhost' 中的 'localhost' 是 MySQL “认为”的客户端来源，不是你写的配置值——它由连接方式决定。

直接进 phpEnv 自带的 MySQL 命令行（比如打开 phpEnv 控制面板 → MySQL → CLI），执行：

SELECT User, Host FROM mysql.user WHERE User = 'root';

如果结果里没有 root + localhost 这一行，那这个用户根本不存在，报错就不是密码问题，而是账号压根没配。

Accessory Bundles

为多SKU配件店铺（如全系列手机壳、表带）设计交叉销售和捆绑结构。当用户提及捆绑销售时使用。

下载

补一条：用 CREATE USER 'root'@'localhost' IDENTIFIED BY 'your_password';
再授予权限：GRANT ALL PRIVILEGES ON *.* TO 'root'@'localhost' WITH GRANT OPTION;
必须执行 FLUSH PRIVILEGES;，否则不生效
注意：不要只写 CREATE USER 'root' IDENTIFIED BY ...——缺省 host 是 '%'，跟 localhost 不是一回事

MySQL 8.0+ 认证插件不兼容 mysqli/pdo_mysql 扩展

phpEnv 新版本常捆绑 MySQL 8.0+，而它的默认认证插件是 caching_sha2_password，但旧版 PHP（尤其 7.2 及更早）的 mysqli 或 PDO 扩展不支持该协议，连接时就会假性报“密码错误”。

现象很典型：命令行 mysql -u root -p 能登录，PHP 却报 Access denied；或者换一台老服务器就正常，新环境必现。

查当前用户插件：SELECT Host, User, plugin FROM mysql.user WHERE User = 'root';
如果是 caching_sha2_password，立刻切回兼容模式：ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_password';
执行 FLUSH PRIVILEGES; 后重启 MySQL 服务（phpEnv 面板里点“重启 MySQL”即可）
PHP 无需改代码，也不用升级扩展——这是服务端协议降级，最稳的解法