PHP Cookie 實作使用者瀏覽歷史記錄（含去重與容量控制）

需求分析

• 記錄使用者瀏覽過的商品/文章 ID
• 最新瀏覽優先顯示
• 去重：同一 ID 只保留最新時間
• 限制筆數（如 10 筆），超過移除最舊
• 資料持久化於 Cookie（客戶端），無需資料庫

完整實作

class BrowseHistory
{
    const COOKIE_NAME = 'browse_history';
    const MAX_ITEMS = 10;
    const EXPIRE_DAYS = 30;

    public static function add(int $itemId): bool
    {
        $history = self::get();

        // 移除舊有相同項目
        $history = array_values(array_filter($history, fn($item) => $item['id'] !== $itemId));

        // 加入最新
        array_unshift($history, [
            'id' => $itemId,
            'time' => date('c'), // ISO 8601 格式
        ]);

        // 限制筆數
        if (count($history) > self::MAX_ITEMS) {
            $history = array_slice($history, 0, self::MAX_ITEMS);
        }

        return self::save($history);
    }

    public static function get(): array
    {
        if (empty($_COOKIE[self::COOKIE_NAME])) {
            return [];
        }
        $data = json_decode($_COOKIE[self::COOKIE_NAME], true);
        return is_array($data) ? $data : [];
    }

    private static function save(array $history): bool
    {
        $json = json_encode($history);
        // Cookie 大小限制 4KB，若超過可改用 LocalStorage + AJAX 同步
        return setcookie(
            self::COOKIE_NAME,
            $json,
            time() + self::EXPIRE_DAYS * 86400,
            '/',      // 路徑
            '',       // 域名（空=當前）
            false,    // Secure (HTTPS 才傳)
            true      // HttpOnly (防 XSS 讀取)
        );
    }

    public static function clear(): bool
    {
        return setcookie(self::COOKIE_NAME, '', time() - 3600, '/');
    }
}

使用範例

// 商品頁面
require 'BrowseHistory.php';
$productId = (int)($_GET['id'] ?? 0);
if ($productId > 0) {
    BrowseHistory::add($productId);
}

// 顯示歷史（側邊欄）
$history = BrowseHistory::get();
if ($history) {
    echo '
最近瀏覽
';
    foreach ($history as $item) {
        // 這裡需自行查詢商品標題/連結
        echo "
商品 #{$item['id']} ({$item['time']})
";
    }
    echo '
';
}

注意事項與替代方案

進階：加密 Cookie 內容

// 儲存前加密
$encrypted = openssl_encrypt(json_encode($history), 'aes-256-gcm', $key, OPENSSL_RAW_DATA, $iv, $tag);
$payload = base64_encode($iv . $tag . $encrypted);
setcookie(self::COOKIE_NAME, $payload, ...);

// 讀取時解密
$raw = base64_decode($_COOKIE[self::COOKIE_NAME]);
$iv = substr($raw, 0, 16);
$tag = substr($raw, 16, 16);
$ciphertext = substr($raw, 32);
$json = openssl_decrypt($ciphertext, 'aes-256-gcm', $key, OPENSSL_RAW_DATA, $iv, $tag);
$history = json_decode($json, true);

1. 上一篇文章： PHP 分頁類別實作：靈活的頁碼導航產生器
2. 下一篇文章： Symfony 十分鐘入門：從安裝到完成 CRUD 完整實戰

PHP 綜合知識

PHP array_map() 多陣列回調函數完整指南

PHP array_map()：對陣列元素套用回調函數 ar

PHP 學習路線圖：從入門到就業的三階段規劃

想系統性地學習 PHP 卻無從下手？本文梳理出一條清晰的進階

mysql_query() 返回值陷阱：為什麼 INSERT/UPDATE 不需要 mysql_free_result()

現象復現 $res = mysql_query(INSERT

PHP 基底控制器實現未登入自動導向登入頁：Session 檢查、中介層模式、AOP 切面替代方案

核心需求 所有需登入的頁面/控制器，**集中攔截未登入請求*