萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP PDO 連接報錯 SQLSTATE[HY000] [2002] 徹底解決方案

錯誤現象

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 路徑各不相同。

快速定位真實 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

1. 找到正確的 php.ini

php --ini
# 載入的配置文件: /etc/php/8.2/cli/php.ini
# 或 Web 環境: /etc/php/8.2/fpm/php.ini, /usr/local/php/etc/php.ini

2. 修改三項 Socket 設置

[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,需同步修改。

3. 重啟服務生效

# 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.sockbrew services start mysql 後生成
MacOS XAMPP/Applications/XAMPP/xamppfiles/var/mysql/mysql.sockXAMPP 控制面板啟動 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 連接

替代方案:改用 TCP 連接 (繞過 Socket)

若不想折騰 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();
}
?>

總結

  1. 用 find / -name 'mysql.sock' 或 MySQL 命令查詢真實路徑。
  2. 在對應 php.ini 中同步設置 pdo_mysql.default_socket、mysql.default_socket、mysqli.default_socket。
  3. 重啟 PHP 進程 (FPM/Apache) 生效。
  4. 或直接在 DSN 使用 host=127.0.0.1 走 TCP 徹底避開 Socket 問題。
copyright © 萬盛學電腦網 all rights reserved