萬盛學電腦網

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

PHP setcookie 完整實戰:設置、驗證、加密簽名、安全屬性

setcookie() 函數完整簽名

setcookie(
    string $name,
    string $value = "",
    int $expires_or_options = 0,
    string $path = "",
    string $domain = "",
    bool $secure = false,
    bool $httponly = false
): bool

// PHP 7.3+ 支援選項數組
setcookie(string $name, string $value = "", array $options = []): bool

參數詳解與最佳實踐

參數說明推薦值
nameCookie 名稱,避免 . [] 等特殊字符字母數字下劃線
value值,自動 urlencode,取時自動 urldecodeJSON/序列化/簽名Token
expiresUnix 時間戳,0=會話結束,負數=刪除time()+3600 (1h) 視業務而定
path生效路徑/ (全站) 或具體路徑 /app/
domain生效域名.example.com 共享子域,留空=當前域
secure僅 HTTPS 傳輸true (生產環境強制)
httponlyJS 不可讀 (document.cookie)true (防 XSS 竊取 Session/Token)
samesiteCSRF 防護 (PHP 7.3+ options)Lax (平衡) / Strict (嚴格)

安全增強:簽名 Cookie 防篡改

<?php
class SecureCookie {
    private string $secret;
    private string $domain;
    private bool $secure;
    
    public function __construct(string $secret, string $domain = '', bool $secure = true) {
        $this->secret = $secret;
        $this->domain = $domain;
        $this->secure = $secure;
    }
    
    // 設置簽名 Cookie
    public function set(string $name, mixed $value, int $expire = 3600, string $path = '/'): bool {
        $payload = json_encode(['v' => $value, 'exp' => time() + $expire], JSON_UNESCAPED_UNICODE);
        $signature = $this->sign($payload);
        $cookieValue = base64_url_encode($payload . '.' . $signature);
        
        return setcookie($name, $cookieValue, [
            'expires' => time() + $expire,
            'path' => $path,
            'domain' => $this->domain ?: null,
            'secure' => $this->secure,
            'httponly' => true,
            'samesite' => 'Lax'
        ]);
    }
    
    // 驗證並獲取值
    public function get(string $name): mixed {
        $cookie = $_COOKIE[$name] ?? '';
        if (!$cookie) return null;
        
        $decoded = base64_url_decode($cookie);
        if (!$decoded) return null;
        
        [$payload, $signature] = explode('.', $decoded, 2);
        if (!$payload || !$signature) return null;
        
        if (!hash_equals($this->sign($payload), $signature)) {
            $this->delete($name); // 簽名無效,刪除
            return null;
        }
        
        $data = json_decode($payload, true);
        if (!$data || !isset($data['v'], $data['exp'])) return null;
        
        if ($data['exp'] < time()) {
            $this->delete($name); // 過期刪除
            return null;
        }
        
        return $data['v'];
    }
    
    public function delete(string $name, string $path = '/'): bool {
        return setcookie($name, '', [
            'expires' => time() - 3600,
            'path' => $path,
            'domain' => $this->domain ?: null,
            'secure' => $this->secure,
            'httponly' => true,
            'samesite' => 'Lax'
        ]);
    }
    
    private function sign(string $data): string {
        return hash_hmac('sha256', $data, $this->secret);
    }
}

// Base64URL 編碼 (無 + / =)
function base64_url_encode(string $data): string {
    return rtrim(strtr(base64_encode($data), '+/', '-_'), '=');
}
function base64_url_decode(string $data): string {
    return base64_decode(strtr($data, '-_', '+/'));
}

// 使用
$cookie = new SecureCookie('super-secret-key-32-bytes-long!', '.example.com', true);
$cookie->set('user_id', 12345, 86400); // 1天
$userId = $cookie->get('user_id'); // 自動驗證簽名、過期
?>

完整登錄記憶我功能實現

<?php
// login.php
session_start();
require 'SecureCookie.php';

$cookie = new SecureCookie($_ENV['COOKIE_SECRET'], $_ENV['COOKIE_DOMAIN'], true);

if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    $username = $_POST['username'] ?? '';
    $password = $_POST['password'] ?? '';
    $remember = isset($_POST['remember']);
    
    // 驗證用戶 (省略)
    $user = authenticate($username, $password);
    
    if ($user) {
        $_SESSION['user_id'] = $user['id'];
        $_SESSION['username'] = $user['username'];
        
        if ($remember) {
            // 長效記憶 Token (30天)
            $selector = bin2hex(random_bytes(16));
            $validator = bin2hex(random_bytes(32));
            $hashedValidator = password_hash($validator, PASSWORD_DEFAULT);
            
            // 存入數據庫
            $pdo->prepare("INSERT INTO remember_tokens (selector, validator, user_id, expires) VALUES (?, ?, ?, DATE_ADD(NOW(), INTERVAL 30 DAY))")
                ->execute([$selector, $hashedValidator, $user['id']]);
            
            // Cookie 存 selector:validator
            $cookie->set('remember_token', $selector . ':' . $validator, 30*86400);
        }
        
        header('Location: /dashboard');
        exit;
    }
    $error = '用戶名或密碼錯誤';
}

// 自動登錄檢查 (每次請求)
if (empty($_SESSION['user_id']) && ($token = $cookie->get('remember_token'))) {
    [$selector, $validator] = explode(':', $token, 2);
    $stmt = $pdo->prepare("SELECT user_id, validator FROM remember_tokens WHERE selector = ? AND expires > NOW()");
    $stmt->execute([$selector]);
    $row = $stmt->fetch();
    
    if ($row && password_verify($validator, $row['validator'])) {
        // 登錄用戶
        $_SESSION['user_id'] = $row['user_id'];
        // 旋轉 Token (安全最佳實踐)
        $newValidator = bin2hex(random_bytes(32));
        $pdo->prepare("UPDATE remember_tokens SET validator = ? WHERE selector = ?")
            ->execute([password_hash($newValidator, PASSWORD_DEFAULT), $selector]);
        $cookie->set('remember_token', $selector . ':' . $newValidator, 30*86400);
    } else {
        $cookie->delete('remember_token');
    }
}
?>

Cookie 限制與邊界

  • 大小限制:單個 Cookie ≤ 4KB,域名總計 ≤ 20-50 個 (瀏覽器依賴)。
  • 同源策略:Scheme+Domain+Port 必須匹配。
  • 第三方 Cookie 限制:Safari ITP、Chrome 階段性棄用,跨域追蹤方案失效。
  • 用戶可禁用/清除:不可依賴 Cookie 存儲關鍵業務數據。

調試技巧

<?php
// 查看原始 Cookie Header
echo "Raw Cookie Header: " . ($_SERVER['HTTP_COOKIE'] ?? 'none') . "\n";

// 解析所有 Cookie (處理同名不同路徑)
$cookies = [];
foreach (explode(';', $_SERVER['HTTP_COOKIE'] ?? '') as $pair) {
    [$k, $v] = array_map('trim', explode('=', $pair, 2));
    $cookies[$k] = urldecode($v);
}
print_r($cookies);
?>

總結

setcookie() 看似簡單,實則涉及安全屬性 (HttpOnly/Secure/SameSite)、簽名防篡改、記憶我 Token 轉換、域名/路徑作用域等多層考量。封裝 SecureCookie 類統一管理,配合數據庫 Token 旋轉,構建企業級認證體系。

copyright © 萬盛學電腦網 all rights reserved