ERROR 2002 (HY000) 表示PHP通过Unix套接字连接MySQL失败，主因是socket文件路径不匹配或MySQL服务未启动；需统一修正my.cnf、php.ini及代码中的socket路径，并确保host设为127.0.0.1而非localhost。
phpEnv 的 MySQL 2002 错误本质是套接字路径不匹配或服务未启动，不是配置文件写错就能解决的。
MySQL 2002 错误具体指什么
错误信息 mysql_connect(): [2002] No such file or directory 或 mysqli_connect(): (HY000/2002): No such file or directory 表明 PHP 尝试通过 Unix 套接字连接 MySQL，但指定的 socket 文件根本不存在或路径不对。
常见现象包括：
- phpMyAdmin 打不开，报
#2002 - 无法登录 MySQL 服务器 -
mysqli_connect()直接返回 false，mysqli_connect_error()输出No such file or directory - 命令行执行
mysql -u root -p成功，但 PHP 连不上 —— 说明 MySQL 服务在跑，只是 PHP 找不到它
检查并修正 socket 路径
phpEnv 默认把 MySQL 编译进本地环境，socket 文件通常不在 /var/run/mysqld/mysqld.sock（这是 Debian/Ubuntu 系统默认），而是在 phpEnv 自建目录下，比如 /phpenv/mysql/data/mysql.sock 或 /phpenv/mysql/tmp/mysql.sock。
立即学习“PHP免费学习笔记（深入）”；
操作步骤：
- 先确认 MySQL 实际监听的 socket：启动 phpEnv 后运行
/phpenv/mysql/bin/mysqladmin -u root -p variables | grep socket（密码为空可直接回车） - 找到输出中类似
socket | /phpenv/mysql/tmp/mysql.sock的行 - 在 PHP 配置中统一指向该路径：
– 修改/phpenv/php/etc/php.ini，确保有mysqli.default_socket = /phpenv/mysql/tmp/mysql.sock
– 修改/phpenv/apache/conf/extra/httpd-vhosts.conf或主配置里php_admin_value mysqli.default_socket（如果用了 Apache） - 重启 Apache 或 PHP-FPM：
/phpenv/apache/bin/apachectl restart或/phpenv/php/sbin/php-fpm -R
php.ini 中 host 设置不能写 localhost
这是最常踩的坑：当 host 设为 "localhost"，PHP 会强制走 Unix socket，忽略 port；设为 "127.0.0.1" 才走 TCP/IP。如果 socket 路径错了，用 "localhost" 必然 2002。
修复方式：
- 代码中连接时显式指定 IP：
new mysqli("127.0.0.1", "root", "", "test") - 或者在
php.ini中加mysqli.default_host = 127.0.0.1（注意不是localhost） - 验证是否生效：写个
test.php输出ini_get("mysqli.default_host")和ini_get("mysqli.default_socket")
MySQL 服务根本没起来
phpEnv 的 MySQL 启动脚本有时不自动拉起，尤其 Windows 下用 WSL 或 macOS 上权限异常时。
排查方法：
- 运行
/phpenv/mysql/bin/mysqld --defaults-file=/phpenv/mysql/my.cnf --user=root看是否报错（如Can't start server: Bind on TCP/IP port或Can't create/write to file '/phpenv/mysql/tmp/...） - 检查
/phpenv/mysql/tmp/目录是否存在、权限是否为当前用户可读写（chmod 755 /phpenv/mysql/tmp） - 确认
my.cnf中pid-file和socket路径的父目录都已创建且可写 - 首次安装后必须手动初始化：
/phpenv/mysql/scripts/mysql_install_db --defaults-file=/phpenv/mysql/my.cnf --user=root
真正麻烦的点在于：phpEnv 没有统一的服务管理入口，MySQL、Apache、PHP 各自启停逻辑不同，socket 路径又分散在 my.cnf、php.ini、代码三处 —— 改错一个地方，其他两处可能还在用旧值。建议每次改完立刻用 php -i | grep -i socket 和 mysqladmin variables | grep socket 双向核对。
