phpenv 的 mysql socket 路径不在系统默认位置，而是在其自建运行目录下，如 /opt/phpenv/versions/8.2.0/var/run/mysqld/mysqld.sock，需通过 phpe mysql status 或 ps aux | grep mysqld 查看实际 --socket= 参数确认，且 php 连接时 dsn 必须明确使用 unix_socket= 并确保目录权限为 755、进程有访问权限。
phpEnv 默认不启用 MySQL 的 socket 连接，而是走 TCP（127.0.0.1:3306），所以当你在 PHP 应用里硬编码或环境变量里填了 MYSQL_DATABASE_SOCKET，或者 PDO/MySQLi 显式指定 unix_socket 参数，却没确认 phpEnv 实际生成的 socket 路径，就会直接报错 Can't connect to local MySQL server through socket。
phpEnv 的 MySQL socket 路径在哪？
phpEnv 安装的 MySQL（通常是 MariaDB 或 Percona）默认不把 socket 文件放在常见路径（比如 /var/run/mysqld/mysqld.sock 或 /tmp/mysql.sock），而是在其自建的运行目录下，例如：
/opt/phpenv/versions/8.2.0/var/run/mysqld/mysqld.sock
这个路径由 phpEnv 启动脚本动态生成，不是靠 /etc/my.cnf 静态决定的。你不能只查系统级配置文件，得看 phpEnv 自己的启动逻辑。
- 先确认当前生效的 MySQL 实例：运行
phpe mysql status或ps aux | grep mysqld，找带--socket=参数的进程行 - 如果看到类似
--socket=/opt/phpenv/versions/8.2.0/var/run/mysqld/mysqld.sock，那就是真实路径 - 该路径下的
mysqld.sock文件必须存在、类型为s（socket）、属主是运行 MySQL 的用户（通常是phpe或mysql）
PHP 代码里指定 unix_socket 失败的典型原因
即使你找到了正确路径，PHP 仍可能连不上，因为：
- PDO 构造 DSN 时写成
unix_socket=/opt/.../mysqld.sock，但没加host=，导致底层仍尝试走 TCP —— 正确写法是：mysql:unix_socket=/opt/.../mysqld.sock;dbname=test，且不能同时设host=127.0.0.1 - MySQLi 使用
mysqli_init()+mysqli_real_connect()时，第 5 个参数（socket）必须是非空字符串，传null或空字符串会被忽略，回退到默认行为 - PHP 进程（如 Apache 子进程或 CLI 用户）对 socket 文件路径没有读/执行权限 —— 注意：不是“读文件”，而是“进入目录并访问 socket 端点”，所以
/opt/phpenv/versions/8.2.0/var/run/mysqld/目录权限至少要 755，且属组可执行
绕过 socket、强制走 TCP 是最稳的临时方案
如果你只是想让应用快速跑起来，不追求极致本地性能，就别碰 socket：
- 在 PDO DSN 中明确用
host=127.0.0.1（不是localhost）：它会强制走 TCP/IP，跳过 socket 查找逻辑 - 环境变量如
MYSQL_HOST=127.0.0.1、MYSQL_PORT=3306，比MYSQL_SOCKET更可靠 - phpEnv 的
mysql命令行客户端默认也走 TCP，除非你显式加--socket=；所以mysql -h127.0.0.1 -uroot -p肯定通，而mysql -uroot -p可能挂 —— 这本身就是一个诊断信号
真正麻烦的是当你的部署流程（比如 Laravel 的 .env、Docker Compose 的 extra_hosts）隐式依赖 socket，又没暴露 phpEnv 的实际路径变量。这时候别改代码，先用 phpe mysql show-config（如有）或翻 ~/.phpenv/versions/*/etc/my.cnf 看 [mysqld] 下的 socket 值，再同步到所有用到的地方 —— 路径不一致，永远连不上。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
