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
| 參數 | 說明 | 推薦值 |
|---|---|---|
| name | Cookie 名稱,避免 . [] 等特殊字符 | 字母數字下劃線 |
| value | 值,自動 urlencode,取時自動 urldecode | JSON/序列化/簽名Token |
| expires | Unix 時間戳,0=會話結束,負數=刪除 | time()+3600 (1h) 視業務而定 |
| path | 生效路徑 | / (全站) 或具體路徑 /app/ |
| domain | 生效域名 | .example.com 共享子域,留空=當前域 |
| secure | 僅 HTTPS 傳輸 | true (生產環境強制) |
| httponly | JS 不可讀 (document.cookie) | true (防 XSS 竊取 Session/Token) |
| samesite | CSRF 防護 (PHP 7.3+ options) | Lax (平衡) / Strict (嚴格) |
<?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');
}
}
?>
<?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 旋轉,構建企業級認證體系。