Linux PHP-FPM錯誤排查方法

在Linux系統中排查PHP-FPM錯誤可以通過以下幾個步驟進行：

1. 查看錯誤日志

   • 首先查看PHP-FPM的錯誤日志，這是最重要的診斷信息來源。

   sudo tail -f /var/log/php7.x-fpm.log  # 根據實際版本替換x
   # 或使用通用路徑
   sudo tail -f /var/log/php-fpm.log
   

2. 檢查配置文件語法

   • 驗證PHP-FPM主配置文件語法。

   sudo php-fpm7.x -t  # 測試配置文件語法
   

3. 常見問題及解決方案

   • 端口/套接字沖突
     • 錯誤表現：Address already in use 或 socket already in use
     • 解決方案：

       # 檢查哪個進程占用了端口/套接字
       sudo netstat -tulnp | grep 9000 # 默認端口是9000
       # 或者如果是unix socket方式
       sudo lsof /run/php/php7.x-fpm.sock
       # 殺死占用進程或修改PHP-FPM監聽端口
       sudo nano /etc/php/7.x/fpm/pool.d/www.conf
       # 修改 listen = 127.0.0.1:9000 為其他端口如 9001
       

   • 權限問題
     • 錯誤表現：Permission denied 相關錯誤
     • 解決方案：

       # 確保套接字文件目錄存在且有正確權限
       sudo mkdir -p /run/php
       sudo chown -R www-data:www-data /run/php
       # 根據實際用戶組調整
       # 檢查pool配置中的用戶/組設置
       sudo nano /etc/php/7.x/fpm/pool.d/www.conf
       # 確保 user 和 group 設置正確（通常為 www-data）
       

   • 資源限制
     • 錯誤表現：Unable to create or open pid file 或資源不足錯誤
     • 解決方案：

       # 增加進程限制
       sudo nano /etc/php/7.x/fpm/php-fpm.conf
       # 檢查并調整 process.max 設置
       # 或者檢查系統限制
       ulimit -n
       # 如果需要增加限制
       sudo nano /etc/security/limits.conf
       # 添加：
       # www-data soft nofile 65535
       # www-data hard nofile 65535
       

   • 擴展加載失敗
     • 錯誤表現：Unable to load dynamic library 或模塊相關錯誤
     • 解決方案：

       # 檢查已安裝的PHP模塊
       php -m
       # 檢查php.ini中的擴展加載行
       sudo nano /etc/php/7.x/fpm/php.ini
       # 注釋掉有問題的擴展行
       # 或者重新安裝有問題的擴展
       sudo apt-get install --reinstall php7.x-modulename
       

4. 重啟服務

   • 在做出更改后，重啟 PHP-FPM 服務。

   sudo systemctl restart php7.x-fpm
   # 或使用service命令
   sudo service php7.x-fpm restart
   

5. 其他排查方法

   • 如果仍然無法啟動，可以嘗試以調試模式運行。

   sudo php-fpm7.x -F -R -y /etc/php/7.x/fpm/php-fpm.conf
   

   這將在前臺運行并顯示詳細錯誤信息。

6. 檢查依賴關系

   • 確保所有依賴項已安裝。

   sudo apt-get install -f  # 修復損壞的依賴關系
   sudo apt-get update
   sudo apt-get upgrade
   

通過以上步驟，可以幫助您解決 PHP7-FPM 啟動失敗的問題。如果問題仍然存在，請根據具體的錯誤信息進一步排查。