PHP "Cannot modify header information" 錯誤徹底解決指南

2. 輸出緩衝：ob_start()（快速修復、舊專案適用）

<?php
// 入口檔最開頭（在任何輸出前）
ob_start(); // 開啟輸出緩衝，所有 echo 暫存記憶體

// ... 正常代碼 ...
echo '內容';
header('Location: success.php'); // 此時仍可修改 header
setcookie('token', $value);
session_start();

// 腳本結束時自動刷新緩衝，或手動
ob_end_flush();

注意：

• ob_start() 會增加記憶體用量（大輸出時注意）
• 巢狀 ob_start() 需配對 ob_end_flush()/clean()
• 無法解決 已發送到瀏覽器 的輸出（如 flush()、Web Server 緩衝滿）

3. php.ini 設定 output_buffering（系統級、影響所有腳本）

; php.ini
output_buffering = 4096 ; 4KB 內部緩衝，或 On 表示無限
; 重啟 PHP-FPM/Apache 生效

優缺點：一勞永逸，但隱藏了架構問題（輸出順序錯誤），除錯時較難發現過早輸出。

4. 重構架構：分離邏輯與輸出（現代最佳實踐）

<?php
// Controller / Action
function loginAction(): void {
    // 1. 純邏輯：驗證、設定 Session、Cookie、資料庫
    if ($valid) {
        $_SESSION['user'] = $user;
        setcookie('remember', $token, time()+86400, '/', '', true, true);
        // 2. 回應物件（不直接輸出）
        return new RedirectResponse('/dashboard');
    }
    // 3. 失敗回應
    return new ViewResponse('login.php', ['error' => '帳號密碼錯誤']);
}

// Front Controller / Router
$response = $router->dispatch($request);
// 統一發送 Header + Body
$response->send();

採用 PSR-7 Response 介面（Guzzle, Symfony HttpFoundation, Laravel Response, Slim 等），徹底消除「何時輸出」的時序耦合。

除錯技巧

<?php
// 臨時加在懷疑位置，追蹤輸出來源
function debugOutputStarted(): void {
    $trace = debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS, 10);
    error_log('Output started trace: ' . json_encode(array_map(fn($f) => [
        'file' => $f['file'] ?? 'unknown',
        'line' => $f['line'] ?? 0,
        'function' => $f['function'] ?? 'unknown',
    ], $trace)));
}

// 或使用 headers_sent() 檢查
if (headers_sent($file, $line)) {
    error_log("Headers already sent in $file:$line");
}

總結檢查清單

1. 檢查 output started at 指向的檔案:行號
2. 該檔案是否有 BOM/空白/HTML/echo/錯誤訊息？
3. 是否被其他檔案 include 且該檔案有輸出？
4. 是否在 header()/session_start()/setcookie() 前有輸出？
5. 依優先級套用：修正源頭 → ob_start() → php.ini → 重構回應物件