答案是socket路径不匹配：phpEnv中PHP配置的MySQL socket路径与MySQL实际监听路径不一致，导致“Cannot connect to MySQL server”错误；需通过STATUS或mysql --verbose --help确认MySQL真实socket路径，再统一修改php.ini中mysqli.default_socket等三项配置，并重启服务，或临时改用127.0.0.1走TCP连接绕过。
phpEnv 连接 localhost 报 “Cannot connect to MySQL server” 是 socket 路径不匹配
phpEnv 默认用 Unix socket 连 MySQL，但 PHP 配置里指向的 socket 文件路径和 MySQL 实际监听的路径对不上，就会报这个错——不是网络不通，也不是账号错，纯粹是两个进程“约错了见面地点”。
先确认 MySQL 的真实 socket 路径：登录 MySQL 后执行 STATUS;，找 UNIX socket 行；或者运行 mysql --verbose --help | grep "Default options" 查默认配置位置。常见路径有：/tmp/mysql.sock、/var/run/mysqld/mysqld.sock、/usr/local/var/mysql/mysql.sock（macOS Homebrew）。
再查 PHP 当前用的 socket 路径：建个 phpinfo.php，访问后搜 mysqli.default_socket、pdo_mysql.default_socket、mysql.default_socket（如果还启用着旧扩展）。三者必须和 MySQL 实际路径一致。
- 不一致？改
php.ini，把上面三个配置项全设成 MySQL 真实的 socket 路径，例如：mysqli.default_socket = /tmp/mysql.sock - 改完重启 Web 服务或 php-fpm，别只刷新页面
- 不确定 MySQL socket 路径？临时用 TCP 强制绕过：把连接 host 从
localhost改成127.0.0.1，这样 PHP 会走 TCP/IP 而非 socket，跳过路径校验
为什么 localhost 会走 socket 而 127.0.0.1 走 TCP
这是 MySQL 客户端协议层的硬规则：localhost 是特殊关键字，PHP 的 mysqli 扩展遇到它会自动选择 Unix domain socket 连接；而任何 IP 地址（包括 127.0.0.1）都会触发 TCP 连接流程。
立即学习“PHP免费学习笔记（深入）”；
这意味着：即使你本地 MySQL 只监听 socket、没开 TCP 端口，mysqli_connect("localhost",...) 仍可能成功；但换用 "127.0.0.1" 就会报 Connection refused——因为 3306 端口根本没在监听。
- 验证是否监听 TCP：运行
lsof -i :3306或netstat -tuln | grep :3306，有输出才说明 MySQL 启用了 TCP - 想让
localhost也走 TCP？不行，这是客户端行为，无法强制；只能换 host 值 - 开发时统一用
127.0.0.1更可控，避免 socket 路径漂移带来的隐性故障
phpEnv 环境下 socket 错误的典型表现和快速验证法
报错信息里带 No such file or directory 或 Can't connect to local MySQL server through socket，基本可锁定为 socket 路径问题。不要急着重装，先做三件事：
- 运行
php -r "var_dump(mysqli_connect('127.0.0.1','root','','test'));"—— 如果返回 resource，说明 MySQL 服务正常，纯属 socket 配置问题 - 运行
ls -l $(mysql --verbose --help 2>/dev/null | grep "Default options" | head -1 | awk '{print $NF}' | sed 's/,$//')，看 socket 文件是否存在且权限可读 - 检查 phpEnv 的
php.ini是否被多处加载：执行php --ini看 CLI 加载路径，phpinfo()看 Web SAPI 加载路径，二者可能不同
Windows 下 phpEnv 几乎不会遇到 socket 错误，但要注意命名管道
Windows 版 MySQL 默认用命名管道（\.pipeMySQL）而非 Unix socket，而 phpEnv 多数基于 Linux/macOS 工具链模拟，容易忽略这点。如果你在 Windows 上用 phpEnv（比如通过 WSL 或 Docker），实际 MySQL 很可能跑在 Windows 原生服务里，此时 PHP 客户端必须能跨子系统访问该管道——这几乎不可靠。
- 最稳方案：在 WSL 内完整安装 MySQL Server（
sudo apt install mysql-server），让 PHP 和 MySQL 同环境 - 若必须连 Windows 原生 MySQL，请改用
host.docker.internal（Docker Desktop）或宿主机 IP（如192.168.x.x），并确保 MySQL 配置了bind-address = 0.0.0.0且用户 host 是% - 别信 phpEnv 文档里“开箱即用”的说法，Windows + phpEnv + 原生 MySQL 是已知高危组合
