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_timeout | FPM 池 | 低 (最終兜底) | 防止 FPM 強殺進程 |
<?php
// 設置為無限制 (僅 CLI 或明確需要時使用)
set_time_limit(0);
// 或設置具體秒數 (如 5 分鐘)
set_time_limit(300);
// 等價寫法
ini_set('max_execution_time', 300);
// 重要:在安全模式下 (已棄用) set_time_limit 無效
// 生產環境建議設置合理上限,避免死循環佔用資源
?>
; php.ini
; 秒為單位,0 = 無限制 (不建議生產環境設 0)
max_execution_time = 300
; CLI 專用配置 (php-cli.ini)
; max_execution_time = 0 ; CLI 通常不限制
# .htaccess
php_value max_execution_time 300
# httpd.conf / vhost.conf
php_admin_value max_execution_time 300
即使 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 是進程級硬性殺死,包含所有時間
max_execution_time = 0 (無限制)。php_sapi_name() === 'cli' 判斷環境。單純調大超時時間治標不治本,生產環境建議採用異步處理:
// 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() { /* 耗時邏輯 */ }
}
<?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]);
?>
<?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 超時配置,構建穩健的長任務處理體系。