PHP setcookie() 完全指南：常見失效原因與解決方案

PHP Cookie 設定失效？90% 是這個原因

setcookie() 必須在**任何輸出之前**呼叫，因為 Cookie 是透過 HTTP Response Header 設定。一旦有輸出（含空白、BOM、echo），Header 即鎖定無法修改。

典型錯誤場景

<?php
echo "歡迎"; // 輸出內容
setcookie('name', 'value'); // 錯誤！Header 已發送
?>

開啟 error_reporting(E_ALL) 會看到：

Warning: Cannot modify header information – headers already sent by (output started at ...)

正確寫法

<?php
// 1. 設定 Cookie（最頂端，無任何輸出前）
setcookie('page', 'a.php', time() + 3600, '/'); // 有效期 1 小時，全站可用

// 2. 讀取 Cookie（下次請求才會出現在 $_COOKIE）
$page = $_COOKIE['page'] ?? 'unknown';

// 3. 輸出 HTML
?><!DOCTYPE html>
<html><body>
From <?= htmlspecialchars($page) ?><br><br>
<a href="b.php">Go to b.php</a>
</body></html>

關鍵參數詳解

完整範例：跨頁面追蹤來源

a.php

<?php
setcookie('page', 'a.php', time()+3600, '/');
$from = $_COOKIE['page'] ?? 'unknown';
?><!DOCTYPE html>
<html><body>
From <?= htmlspecialchars($from) ?><br><br>
<a href="b.php">Go to b.php</a>
</body></html>

b.php

<?php
setcookie('page', 'b.php', time()+3600, '/');
$from = $_COOKIE['page'] ?? 'unknown';
?><!DOCTYPE html>
<html><body>
From <?= htmlspecialchars($from) ?><br><br>
<a href="a.php">Back to a.php</a>
</body></html>

除錯清單

1. 確認 setcookie() 在 <?php 開啟標籤後**第一行**執行
2. 檢查檔案編碼為 **UTF-8 無 BOM**
3. 確認無 include/require 引入的檔案有輸出
4. 開啟 error_reporting(E_ALL) 捕捉警告
5. 瀏覽器開發者工具 Network 標籤檢查 Set-Cookie Header