核心问题是php扩展与mysqld实际生成的mysql.sock路径不一致：需先用mysql -e "show variables like 'socket'"查真实路径，再同步修改php.ini中mysql.default_socket、mysqli.default_socket、pdo_mysql.default_socket三项为同一路径，并确保mysqld服务正常运行且目录权限正确。
mysql.sock 路径不一致是核心问题
phpEnv 默认用 Unix socket 连 MySQL，但 PHP 扩展（mysqli、PDO_mysql）读的 socket 路径和 mysqld 实际生成的 mysql.sock 文件路径对不上，就会报“找不到 socket”——不是文件真丢了，而是 PHP 在错的地方找。
常见现象：mysqli_connect(): (HY000/2002): Can't connect to local MySQL server through socket '/tmp/mysql.sock'，而实际 mysql.sock 可能在 /var/run/mysqld/mysqld.sock 或 /usr/local/mysql/tmp/mysql.sock。
- 先确认 mysqld 真实 socket 路径：
mysql -u root -p -e "show variables like 'socket';" - 再查 PHP 当前用的路径：
php -i | grep -i "mysql.default_socket\|mysqli.default_socket\|pdo_mysql.default_socket" - 如果两者不一致，必须让 PHP 配置指向服务端生成的那个路径，不能靠猜或默认值
修改 php.ini 中三个 socket 配置项
PHP 有三套 MySQL 扩展，各自读不同的 ini 配置项，漏改任何一个都可能失效。不是只改 mysqli.default_socket 就够了。
打开你的 phpEnv 对应的 php.ini（通常在 ~/.phpenv/versions/x.x.x/etc/php.ini），在文件末尾或 [MySQLi] / [PDO] 段落里补全以下三项：
mysql.default_socket = /var/run/mysqld/mysqld.sock mysqli.default_socket = /var/run/mysqld/mysqld.sock pdo_mysql.default_socket = /var/run/mysqld/mysqld.sock
注意：/var/run/mysqld/mysqld.sock 要替换成你上一步查到的真实路径；文件名可能是 mysql.sock 或 mysqld.sock，取决于编译或配置；路径必须存在且 mysqld 有写权限。
- 改完后重启 php-fpm 或 Apache/Nginx（如果走 CGI/FastCGI）
- 别忘了验证：运行
php -m | grep -E "(mysql|mysqli|pdo)"确保扩展已加载 - 某些 phpEnv 版本会覆盖用户配置，可加
echo "extension=mysqlic.so"到php.ini确保扩展启用
mysqld 启动失败也会导致 mysql.sock 不出现
很多人以为 mysql.sock 是静态文件，其实它是 mysqld 启动时动态创建的。如果服务根本没起来，mysql.sock 就不会存在——此时改 PHP 配置毫无意义。
检查方法：
- 运行
systemctl status mysqld或service mysql status，看是否 active (running) - 如果状态是 failed，立刻查日志：
journalctl -u mysqld -n 50 --no-pager或看/var/log/mysql/error.log - 常见启动失败原因：
datadir权限不对、my.cnf里socket路径所在目录不存在、磁盘满、端口被占
特别注意：systemctl status 显示 “active (running)” 并不绝对可靠——有时 mysqld 卡在初始化阶段，socket 文件未生成，但进程还活着。最准的办法还是看日志里有没有 mysqld: ready for connections 这行。
临时绕过 socket 直连 TCP 是调试捷径
当不确定 socket 路径或想快速验证数据库是否真能用，可以强制 PHP 走 TCP 连接，跳过 socket 查找逻辑。
在 PHP 代码中把连接参数从 localhost 改成 127.0.0.1：
$conn = new mysqli('127.0.0.1', 'root', 'pass', 'db');
或者 PDO：
$pdo = new PDO('mysql:host=127.0.0.1;dbname=test', 'root', 'pass');
原理：localhost 触发 Unix socket，127.0.0.1 强制走 TCP 回环。只要 mysqld 的 bind-address 允许本地连接（默认是 127.0.0.1 或 *），就能通。
- 这不是长期方案，TCP 比 socket 略慢，且绕过了 Unix 权限控制
- 但它能帮你快速区分问题是出在 socket 配置，还是 mysqld 本身或网络层
- 如果
127.0.0.1能连而localhost不能，基本锁定是 socket 路径或权限问题
真正麻烦的不是路径填错，而是改了 my.cnf 里的 [mysqld] socket 却忘了同步改 [client] 段，或者 PHP 和 MySQL 分属不同环境（如 Docker 容器内外、phpEnv 和系统 MySQL 混用），导致路径映射完全脱节。这种时候，盯着 show variables like 'socket' 和 php -i 输出逐字比对，比任何教程都管用。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
