ubuntu下php-fpm連接數據庫失敗怎么辦

Ubuntu下PHP-FPM連接數據庫失敗的排查與解決步驟

1. 確認PHP MySQL擴展是否安裝并啟用

PHP-FPM連接數據庫需依賴對應的PHP擴展（如mysqli或pdo_mysql）。若未安裝，會導致擴展缺失錯誤。

• 安裝擴展：根據PHP版本選擇對應命令（以PHP 8.1為例）：

  sudo apt-get install php8.1-mysql
  

• 重啟PHP-FPM：安裝后需重啟服務使擴展生效：

  sudo systemctl restart php8.1-fpm
  

• 驗證擴展：創建phpinfo.php文件（內容為<?php phpinfo(); ?>），通過瀏覽器訪問確認擴展是否存在。

2. 檢查MySQL服務運行狀態

若MySQL未啟動，PHP-FPM無法建立連接。

• 查看服務狀態：

  sudo systemctl status mysql
  

• 啟動服務：若未運行，執行以下命令啟動：

  sudo systemctl start mysql
  

• 設置開機自啟（可選）：

  sudo systemctl enable mysql
  

3. 驗證數據庫連接配置信息

PHP代碼中的連接信息（主機名、用戶名、密碼、數據庫名）需與數據庫實際配置一致。

• 常見配置位置：
  • PHP代碼中的mysqli_connect()或PDO連接字符串（如mysql:host=localhost;dbname=test）。
  • 若使用框架（如Laravel），檢查.env文件中的DB_HOST、DB_USERNAME等參數。
• 關鍵檢查項：
  • 主機名：本地開發通常為localhost，遠程數據庫需填寫IP或域名。
  • 用戶名/密碼：確保與MySQL中創建的用戶一致（區分大小寫）。
  • 數據庫名：確認數據庫已存在。

4. 檢查MySQL用戶權限

用戶需具備訪問目標數據庫的權限，否則會返回“Access denied”錯誤。

• 登錄MySQL：

  mysql -u root -p
  

• 查看用戶權限：

  SELECT User, Host FROM mysql.user WHERE User = 'your_username';
  SHOW GRANTS FOR 'your_username'@'localhost';
  

• 授予權限（若權限不足）：

  GRANT ALL PRIVILEGES ON your_database.* TO 'your_username'@'localhost' IDENTIFIED BY 'your_password';
  FLUSH PRIVILEGES;
  

5. 檢查防火墻設置

若PHP-FPM與MySQL位于不同服務器，需開放MySQL端口（默認3306）。

• Ubuntu防火墻（ufw）：

  sudo ufw allow 3306/tcp
  sudo ufw reload
  

• 遠程數據庫服務器：確保防火墻允許來自PHP-FPM服務器的IP訪問3306端口。

6. 查看PHP-FPM與MySQL錯誤日志

日志是定位問題的關鍵，可獲取具體錯誤信息（如連接超時、權限拒絕）。

• PHP-FPM錯誤日志：
  • 路徑通常在/var/log/php-fpm.log或/var/log/php8.1-fpm.log（取決于PHP版本）。
  • 若未找到，可通過journalctl查看：

    sudo journalctl -u php8.1-fpm -n 50 --no-pager
    

• MySQL錯誤日志：
  • 路徑通常在/var/log/mysql/error.log，可通過以下命令查看：

    sudo tail -n 50 /var/log/mysql/error.log
    

7. 檢查MySQL綁定地址配置

MySQL默認可能僅綁定到127.0.0.1，導致遠程連接失敗。

• 修改配置文件：編輯/etc/mysql/mysql.conf.d/mysqld.cnf（或/etc/mysql/my.cnf），找到bind-address行：

  bind-address = 0.0.0.0  # 允許所有IP連接（生產環境建議指定具體IP）
  

• 重啟MySQL：

  sudo systemctl restart mysql
  

8. 測試數據庫連接

使用命令行工具驗證連接是否正常，排除PHP代碼問題。

• MySQL命令行測試：

  mysql -h localhost -u your_username -p your_database
  

  輸入密碼后若能進入MySQL命令行，說明連接正常；若失敗，需根據錯誤信息進一步排查（如密碼錯誤、用戶權限不足）。

按照以上步驟逐一排查，通?？山鉀QPHP-FPM連接數據庫失敗的問題。若問題仍存在，建議結合錯誤日志中的具體信息進一步分析（如連接超時需檢查網絡，權限問題需調整用戶權限）。