Connection failed: SQLSTATE[HY000] [2002] No such file or directory
此錯誤表示 PHP 無法通過 Unix Socket 連接到 MySQL 服務,常見於 MacOS (XAMPP/MAMP)、Linux 多 MySQL 實例、Docker 容器互聯 等場景。
PHP PDO 的 pdo_mysql.default_socket 配置指向的 mysql.sock 路徑與 MySQL 實際運行的 Socket 路徑不一致。MySQL 編譯安裝、包管理安裝、XAMPP 整合包、Docker 映射等方式產生的 Socket 路徑各不相同。
# 方法 1: 查找 mysql.sock 文件
sudo find / -name 'mysql.sock' 2>/dev/null
# 常見輸出:
# /tmp/mysql.sock
# /var/lib/mysql/mysql.sock
# /var/run/mysqld/mysqld.sock
# /Applications/XAMPP/xamppfiles/var/mysql/mysql.sock (XAMPP Mac)
# /opt/lampp/var/mysql/mysql.sock (XAMPP Linux)
# 方法 2: 登入 MySQL 客戶端查詢
mysql -u root -p -e "SHOW VARIABLES LIKE 'socket';"
# 輸出範例:
# +---------------+-----------------------------+
# | Variable_name | Value |
# +---------------+-----------------------------+
# | socket | /tmp/mysql.sock |
# +---------------+-----------------------------+
php --ini
# 載入的配置文件: /etc/php/8.2/cli/php.ini
# 或 Web 環境: /etc/php/8.2/fpm/php.ini, /usr/local/php/etc/php.ini
[Pdo_mysql]
pdo_mysql.default_socket = /tmp/mysql.sock ; 改為實際路徑
[MySQL]
mysql.default_socket = /tmp/mysql.sock
[MySQLi]
mysqli.default_socket = /tmp/mysql.sock
注意: CLI 与 FPM/Apache 可能使用不同 php.ini,需同步修改。
# PHP-FPM
systemctl restart php-fpm
# 或
service php-fpm restart
# Apache (mod_php)
systemctl restart httpd
# 或
service apache2 restart
# XAMPP
/Applications/XAMPP/xamppfiles/xampp restartapache
| 環境 | Socket 路徑範例 | 備註 |
|---|---|---|
| MacOS Homebrew MySQL | /tmp/mysql.sock | brew services start mysql 後生成 |
| MacOS XAMPP | /Applications/XAMPP/xamppfiles/var/mysql/mysql.sock | XAMPP 控制面板啟動 MySQL 後生成 |
| Linux (yum/apt 安裝) | /var/lib/mysql/mysql.sock 或 /var/run/mysqld/mysqld.sock | 視發行版而定 |
| Linux 編譯安裝 | /usr/local/mysql/mysql.sock | 編譯時 --with-unix-socket-path 指定 |
| Docker (官方 mysql image) | 容器內 /var/run/mysqld/mysqld.sock | 宿主機需掛載或使用 TCP 連接 |
若不想折騰 Socket,可強制 PDO 使用 127.0.0.1 TCP 連接:
$dsn = 'mysql:host=127.0.0.1;port=3306;dbname=testdb;charset=utf8mb4';
// 注意:使用 127.0.0.1 而非 localhost,localhost 會強制走 Unix Socket
$pdo = new PDO($dsn, $user, $pass, [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
]);
優點: 跨平台一致、無 Socket 路徑依賴、支援遠程連接。
缺點: 本機通訊比 Unix Socket 稍慢 (微秒級),高併發下可考慮連接池。
<?php
try {
$pdo = new PDO('mysql:host=localhost;dbname=test', 'root', 'password');
echo "連接成功!Server version: " . $pdo->query('SELECT VERSION()')->fetchColumn();
} catch (PDOException $e) {
echo "失敗: " . $e->getMessage();
}
?>
find / -name 'mysql.sock' 或 MySQL 命令查詢真實路徑。php.ini 中同步設置 pdo_mysql.default_socket、mysql.default_socket、mysqli.default_socket。host=127.0.0.1 走 TCP 徹底避開 Socket 問題。