为什么phpMyAdmin无法通过Socket方式连接本地MySQL？-phpMyAdmin-PHP中文网

错误源于phpMyAdmin默认socket路径与MySQL实际路径不匹配，需先执行SHOW VARIABLES LIKE 'socket'确认真实路径，再在config.inc.php中准确配置$cfg['Servers'][$i]['socket']，并确保权限和MySQL配置一致。

phpMyAdmin 默认走 socket，但 MySQL 的 socket 路径不匹配

错误 mysqli_real_connect(): (hy000/2002): no such file or directory 几乎总是因为 phpmyadmin 尝试连接一个并不存在的 .sock 文件。它默认找 /var/run/mysqld/mysqld.sock，但你的 mysql 实际 socket 可能在 /tmp/mysql.sock、/var/lib/mysql/mysql.sock，甚至根本没启用 socket（比如某些 docker 镜像只开 tcp）。

必须先确认真实路径：

登录 MySQL 执行：SHOW VARIABLES LIKE 'socket';
或运行：mysql --help | grep "socket"
再用 ls -l 检查该路径是否存在且可读（例如 ls -l /tmp/mysql.sock）

如果路径不存在，说明 MySQL 未启用 socket 连接——常见于配置了 skip-networking 但又没配 socket，或用了非标准安装方式（如 Homebrew on M1/M2、源码编译）。

$cfg['Servers'][$i]['host'] = 'localhost' 会强制走 socket，但 socket 行没配对就失效

phpMyAdmin 中只要 $cfg['Servers'][$i]['host'] 是 'localhost'，PHP 的 MySQLi 就会忽略 port、跳过 TCP，直接尝试 Unix socket 连接。这时如果 $cfg['Servers'][$i]['socket'] 没设、设错、或设了但路径不对，就会报 2002 错误。

正确做法是显式指定 socket 路径：

打开 config.inc.php，找到对应服务器块（通常是 $cfg['Servers'][1]）
添加或修正这一行：$cfg['Servers'][$i]['socket'] = '/tmp/mysql.sock';（路径必须和 SHOW VARIABLES 输出完全一致）
确保 $cfg['Servers'][$i]['host'] = 'localhost';（不能是 '127.0.0.1'）
$cfg['Servers'][$i]['port'] 留空或删掉，避免干扰 socket 逻辑

注意：不写 socket 行 ≠ 自动 fallback 到正确路径；它会硬编码用默认值，而那个默认值在不同系统上差异极大。

socket 文件存在，但 Web 服务用户无权限访问

即使路径对、MySQL 在跑，仍可能报错，现象是命令行 mysql -u root -p 能连，但浏览器里 phpMyAdmin 失败，错误里带 Permission denied。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

这是因为 socket 文件的 owner/group 不包含 Web 服务用户（如 www-data、_www 或 apache）：

运行 ls -l /path/to/mysql.sock，看输出第三、四列
若 owner 不是 Web 用户，需改属组并加读写权限：sudo chgrp www-data /path/to/mysql.sock && sudo chmod g+rw /path/to/mysql.sock
更稳妥的做法是让 MySQL 启动时自动设对权限，在 my.cnf 的 [mysqld] 段加：socket_group = www-data 和 socket_mode = 0660