PHP CLI 或 Web 執行 new mysqli('localhost', 'root', 'pwd', 'db') 拋出:
Warning: mysqli::mysqli(): (HY000/2002): No such file or directory
將 localhost 改為 127.0.0.1 即正常。
| 連線字串 | 傳輸協議 | Socket/端口 | 速度/安全 |
|---|---|---|---|
localhost | Unix Domain Socket | /var/lib/mysql/mysql.sock (或 /tmp/mysql.sock) | 更快、僅本機、無網絡開銷 |
127.0.0.1 | TCP/IP | 3306 端口 | 標準網絡棧、可跨主機、稍慢 |
MySQL 客戶端庫根據主機名決定協議:localhost 強制走 Socket,127.0.0.1 強制走 TCP。若 Socket 檔案不存在、路徑不匹配、權限不足,即報「No such file or directory」。
$mysqli = new mysqli('127.0.0.1', 'root', 'pwd', 'db', 3306);
繞過 Socket 直接走 TCP,無需任何配置修改。現代局域網/本機 TCP 延遲極低(<0.1ms),效能差異可忽略。
[mysqld]
socket=/var/lib/mysql/mysql.sock
[client]
socket=/var/lib/mysql/mysql.sock
重啟 MySQL 後,PHP 端 localhost 會讀取 [client] 區段的 socket 參數。需確認實際 mysql.sock 位置(ls -l /var/lib/mysql/mysql.sock 或 mysql_config --socket)。
$db = new mysqli('localhost', 'root', 'pwd', 'db', 3306, '/var/run/mysqld/mysqld.sock');
第 5 參數為端口(Socket 模式下忽略),第 6 參數為 Socket 路徑。適用於無法修改 my.cnf 的共享主機環境。
user@'localhost' 僅匹配 Socket 連線;user@'127.0.0.1' 僅匹配 TCP 連線;user@'%' 匹配 TCP 但不匹配 localhost。遷移協議時需同步授權。/var/lib/mysql/mysql.sock,檢查 audit.log 或暫時 setenforce 0 測試。localhost 自動解析為 TCP 127.0.0.1,不會出現此錯誤。ls -l /var/lib/mysql/mysql.sock 確認 Socket 存在。mysql -u root -p -S /var/lib/mysql/mysql.sock 測試 Socket 連線。netstat -lnpt | grep 3306 確認 TCP 監聽。php -r "var_dump(mysqli_connect('localhost','root','pwd'));" 對比 127.0.0.1。php.ini mysqli.default_socket 設定。