萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 資料庫 >> MySQL 教學

PHP 連不上 MySQL 但命令列正常?Socket 路徑不匹配排查指南

故障現象

  • PHP 網頁/CLI 連線失敗:Can't connect to local MySQL server through socket
  • 命令列 mysql -u root -p 正常登入操作

根因:Socket 路徑不一致

MySQL Server 建立的 Unix Socket 檔案路徑與 PHP/MySQL 客戶端庫預期路徑不同。常見於:

  • 多 MySQL 實例、非標準安裝路徑
  • PHP 編譯時指定的預設 socket 與運行時實際不符
  • 容器化環境掛載路徑不匹配

三步定位解決

步驟 1:查詢實際 Socket 路徑

mysql -u root -p -e "SHOW VARIABLES LIKE 'socket';"
# 輸出範例
+---------------+-----------------------------+
| Variable_name | Value                       |
+---------------+-----------------------------+
| socket        | /var/run/mysqld/mysqld.sock |
+---------------+-----------------------------+

步驟 2:修正 PHP 配置

; php.ini
; 找到 [MySQL] / [mysqli] / [pdo_mysql] 區塊
mysql.default_socket = /var/run/mysqld/mysqld.sock
mysqli.default_socket = /var/run/mysqld/mysqld.sock
pdo_mysql.default_socket = /var/run/mysqld/mysqld.sock

或運行時動態指定:

$pdo = new PDO("mysql:host=localhost;dbname=test;unix_socket=/var/run/mysqld/mysqld.sock", $user, $pass);
$mysqli = new mysqli("localhost", $user, $pass, "db", 3306, "/var/run/mysqld/mysqld.sock");

步驟 3:重載 PHP-FPM / Apache

systemctl reload php8.2-fpm
# 或
systemctl restart httpd

驗證腳本

connect_errno) {
    echo "連線失敗: " . $mysqli->connect_error . "\n";
    // 嘗試無 socket 參數
    $mysqli2 = @new mysqli("localhost", "root", "pass", "db");
    echo "無 socket 參數: " . ($mysqli2->connect_errno ? "失敗" : "成功") . "\n";
} else {
    echo "連線成功!\n";
    $mysqli->close();
}

其他可能原因快速排查

copyright © 萬盛學電腦網 all rights reserved
現象檢查項目解決
權限拒絕Socket 檔案權限、SELinuxchmod 777 socket 目錄、setsebool -P httpd_can_network_connect_db 1
skip-networking 開啟my.cnf 有 skip-networking註釋或改用 127.0.0.1 TCP 連線
PHP 版本不匹配php-mysqlnd vs libmysqlclient統一用 mysqlnd (原生驅動)
主機名解析/etc/hosts localhost 解析確保 127.0.0.1 localhost