萬盛學電腦網

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

PHP 監控腳本:自動偵測 Nginx 502 並重啟 php-fpm

應用場景

Nginx + PHP-FPM 架構下,PHP-FPM 進程異常退出導致 502 Bad Gateway。半夜無人值守時,需自動偵測並恢復服務。

監控腳本實現

<?php
/**
 * Nginx 502 監控自動重啟腳本
 * 放入 crontab 每分鐘執行: * * * * * /usr/bin/php /path/check_502.php
 */

$config = array(
    'check_url' => 'https://your-domain.com/health', // 健康檢查端點
    'restart_cmd' => '/usr/local/php/sbin/php-fpm restart', // 重啟命令
    'timeout' => 3,           // curl 連線超時
    'max_checks' => 3,        // 連續失敗幾次才重啟(防誤觸)
    'log_file' => '/var/log/php-fpm_monitor.log',
);

function logMsg($msg, $file) {
    $line = date('[Y-m-d H:i:s] ') . $msg . "\n";
    file_put_contents($file, $line, FILE_APPEND | LOCK_EX);
}

$consecutiveFailures = 0;
// 讀取上次失敗計數(簡單持久化)
$stateFile = '/tmp/php_fpm_monitor_state';
if (file_exists($stateFile)) {
    $consecutiveFailures = (int)file_get_contents($stateFile);
}

for ($i = 0; $i < $config['max_checks']; $i++) {
    $cmd = sprintf(
        'curl -s -o /dev/null -w "%%{http_code}" --connect-timeout %d --max-time %d %s 2>/dev/null',
        $config['timeout'],
        $config['timeout'] * 2,
        escapeshellarg($config['check_url'])
    );
    
    $httpCode = trim(shell_exec($cmd));
    
    if ($httpCode === '502') {
        $consecutiveFailures++;
        logMsg("Detected 502 (attempt $consecutiveFailures/{$config['max_checks']})", $config['log_file']);
    } else {
        $consecutiveFailures = 0; // 成功重置計數
        break;
    }
    
    sleep(1); // 間隔 1 秒重試
}

// 更新狀態
file_put_contents($stateFile, $consecutiveFailures, LOCK_EX);

// 達到閾值執行重啟
if ($consecutiveFailures >= $config['max_checks']) {
    logMsg("Threshold reached, executing restart: {$config['restart_cmd']}", $config['log_file']);
    $output = shell_exec($config['restart_cmd'] . ' 2>&1');
    logMsg("Restart output: $output", $config['log_file']);
    
    // 重啟後驗證
    sleep(3);
    $verifyCode = trim(shell_exec($cmd));
    if ($verifyCode !== '502') {
        logMsg("Restart verified OK (HTTP $verifyCode)", $config['log_file']);
        $consecutiveFailures = 0;
    } else {
        logMsg("Restart FAILED, still 502", $config['log_file']);
    }
    file_put_contents($stateFile, $consecutiveFailures, LOCK_EX);
}

健康檢查端點建議

不要用首頁,建立專用輕量端點:

<?php
// health.php
// 1. 檢查資料庫連線
// 2. 檢查 Redis 連線
// 3. 檢查關鍵目錄可寫
// 4. 檢查磁碟空間
// 5. 返回 JSON
header('Content-Type: application/json');
echo json_encode(array('status' => 'ok', 'time' => time()));

Crontab 部署

# 編輯 crontab
crontab -e

# 每分鐘執行(標準用法)
* * * * * /usr/bin/php /opt/scripts/check_502.php > /dev/null 2>&1

# 或使用 flock 防止重疊執行
* * * * * flock -n /tmp/check_502.lock -c '/usr/bin/php /opt/scripts/check_502.php'

系統級替代方案(更健壯)

systemd 服務監控


# /etc/systemd/system/php-fpm-monitor.service
[Unit]
Description=PHP-FPM 502 Monitor
After=network.target

[Service]
Type=oneshot
ExecStart=/usr/bin/php /opt/scripts/check_502.php
User=root

# /etc/systemd/system/php-fpm-monitor.timer
[Unit]
Description=Run PHP-FPM monitor every minute

[Timer]
OnBootSec=1min
OnUnitActiveSec=1min

[Install]
WantedBy=timers.target
systemctl daemon-reload
systemctl enable --now php-fpm-monitor.timer

Supervisor 管理 php-fpm


[program:php-fpm]
command=/usr/local/php/sbin/php-fpm --nodaemonize --fpm-config /usr/local/php/etc/php-fpm.conf
autostart=true
autorestart=true
startretries=3
stderr_logfile=/var/log/php-fpm.err.log
stdout_logfile=/var/log/php-fpm.out.log

Nginx 上游健康檢查(商業版/Plus)


upstream php_backend {
    server 127.0.0.1:9000 max_fails=3 fail_timeout=30s;
    # health_check interval=10s uri=/health;  # Plus 版本
}

根治建議:解決 502 根本原因

  1. PHP-FPM 配置優化:
    • `pm = dynamic` / `ondemand` 根據流量選擇
    • `pm.max_children` 依記憶體計算:`(Total RAM - System) / Avg Process Size`
    • `request_terminate_timeout = 30s` 防止卡死進程
    • `pm.max_requests = 500` 定期回收防記憶體洩漏
  2. 代碼層面:
    • 修復死循環、無限遞迴、大記憶體分配
    • 異步處理耗時任務(隊列 Worker)
    • 設定 `set_time_limit()`、資料庫查詢超時
  3. 系統層面:
    • OOM Killer 調整:`vm.overcommit_memory=1`、`oom_score_adj`
    • 檔案描述符限制:`ulimit -n 65535`
    • 定期輪轉日誌、清理臨時檔案

監控腳本是權宜之計,優化配置與代碼才是根治。建議兩者並行:部署監控保底,持續優化消除 502 根因。

copyright © 萬盛學電腦網 all rights reserved