萬盛學電腦網

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

PHP "Maximum execution time of 30 seconds exceeded" 解決方案全集

錯誤原因

Fatal error: Maximum execution time of 30 seconds exceeded 表示腳本執行時間超過 PHP 配置的 max_execution_time 限制(默認 30 秒)。常見於:大數據導入/導出、批量圖片處理、爬蟲、複雜報表生成、視頻轉碼等長時間任務。

解決方案對比

方法作用範圍優先級推薦場景
set_time_limit()當前腳本最高單一長時間腳本、CLI 腳本
ini_set('max_execution_time', ...)當前腳本高運行時動態調整
php.ini max_execution_time全局中服務器級統一策略
.htaccess / Apache php_value目錄/虛擬主機中共享主機無 php.ini 權限
Nginx + PHP-FPM request_terminate_timeoutFPM 池低 (最終兜底)防止 FPM 強殺進程

詳細配置方法

1. 代碼中動態設置 (推薦)

<?php
// 設置為無限制 (僅 CLI 或明確需要時使用)
set_time_limit(0);

// 或設置具體秒數 (如 5 分鐘)
set_time_limit(300);

// 等價寫法
ini_set('max_execution_time', 300);

// 重要:在安全模式下 (已棄用) set_time_limit 無效
// 生產環境建議設置合理上限,避免死循環佔用資源
?>

2. php.ini 全局配置

; php.ini
; 秒為單位,0 = 無限制 (不建議生產環境設 0)
max_execution_time = 300

; CLI 專用配置 (php-cli.ini)
; max_execution_time = 0  ; CLI 通常不限制

3. Apache (.htaccess / httpd.conf)

# .htaccess

    php_value max_execution_time 300


# httpd.conf / vhost.conf

    php_admin_value max_execution_time 300

4. Nginx + PHP-FPM 關鍵配置

即使 PHP 設置無限制,Nginx 或 FPM 仍可能提前終止請求:

# nginx.conf / site.conf
location ~ \.php$ {
    fastcgi_read_timeout 300s; # 必須大於 PHP max_execution_time
    # ...
}

# php-fpm.d/www.conf
request_terminate_timeout = 300s ; 0 為不限制,建議設置具體值
; 還需注意:
; max_execution_time 不計入系統調用、資料庫等待、sleep() 時間
; request_terminate_timeout 是進程級硬性殺死,包含所有時間

CLI 模式特殊說明

  • CLI SAPI 默認 max_execution_time = 0 (無限制)。
  • Web SAPI (FPM/Apache) 默認 30 秒。
  • 通過 php_sapi_name() === 'cli' 判斷環境。

長任務架構級優化方案

單純調大超時時間治標不治本,生產環境建議採用異步處理:

方案 A:任務隊列 (推薦)

// 1. 控制器:快速入隊,立即返回
public function exportReport() {
    $jobId = Queue::push(ExportReportJob::class, ['user_id' => auth()->id()]);
    return response()->json(['job_id' => $jobId, 'status' => 'queued']);
}

// 2. Worker 後台處理 (無超時限制)
class ExportReportJob implements ShouldQueue {
    public $timeout = 0; // 無限制
    public function handle() { /* 耗時邏輯 */ }
}

方案 B:分塊處理 + 進度輪詢

<?php
// 處理 10 萬條數據,每次 1000 條
$total = 100000;
$chunk = 1000;
$progressKey = 'export_progress_' . $userId;

for ($offset = 0; $offset < $total; $offset += $chunk) {
    // 檢查是否接近時間限制 (如 25 秒)
    if ((microtime(true) - $_SERVER['REQUEST_TIME_FLOAT']) > 25) {
        // 保存進度到 Redis/Session
        Redis::set($progressKey, $offset);
        // 返回繼續標識,前端輪詢下一批
        echo json_encode(['continue' => true, 'offset' => $offset]);
        exit;
    }
    processChunk($offset, $chunk);
}
// 完成
Redis::del($progressKey);
echo json_encode(['done' => true]);
?>

方案 C:流式輸出 (大文件下載/導出)

<?php
set_time_limit(0); // 長連接需取消限制
header('Content-Type: text/csv');
header('Content-Disposition: attachment; filename="export.csv"');

$out = fopen('php://output', 'w');
fputcsv($out, ['ID', 'Name', 'Email']);

$stmt = $pdo->query('SELECT id, name, email FROM users');
while ($row = $stmt->fetch(PDO::FETCH_ASSOC)) {
    fputcsv($out, $row);
    // 定期 flush 避免緩衝區堆積
    if (($cnt++ % 1000) === 0) flush();
}
fclose($out);
?>

除錯技巧

  • 使用 register_shutdown_function() 捕獲致命錯誤日誌。
  • xdebug.profiler_enable=1 分析性能瓶頸。
  • 檢查 sleep()、usleep()、數據庫查詢、外部 API 調用是否佔用大量時間 (不計入 max_execution_time)。

總結

「執行時間超過 30 秒」是 PHP 保護機制,而非 Bug。優先優化算法/數據庫/架構(隊列、分塊、流式),輔以合理的 set_time_limit() 與 FPM/Nginx 超時配置,構建穩健的長任務處理體系。

copyright © 萬盛學電腦網 all rights reserved