PHP Cookie详解：从基础到实战应用

2025-12-17 8185阅读

一、PHP Cookie基础概念

在Web开发中，Cookie是服务器通过HTTP协议传递给浏览器的小型文本文件，用于在客户端（浏览器）保存用户相关信息。PHP作为后端语言，通过内置函数与Cookie进行交互，实现用户状态管理、数据临时存储等功能。与Session不同，Cookie数据存储在客户端，而Session数据存储在服务器端，Cookie更适合存储非敏感的用户偏好、登录状态等信息。

二、PHP中设置Cookie的方法

PHP通过setcookie()函数设置Cookie，其语法为：

setcookie(name, value, expire, path, domain, secure, httponly);

参数说明：

name：Cookie名称（必填），字符串类型；
value：Cookie值（可选），建议使用urlencode()编码避免特殊字符问题；
expire：过期时间（可选），时间戳格式，默认会话结束时过期；
path：Cookie生效路径（可选，默认当前目录）；
domain：生效域名（可选，默认当前域名）；
secure：是否仅HTTPS传输（布尔值，默认false）；
httponly：是否禁止JS读取（布尔值，默认false，设为true可防XSS攻击）。

示例：设置用户登录状态Cookie

// 设置用户ID为123，1小时后过期，仅在根目录生效，禁止JS读取
setcookie(
    "user_id", 
    "123", 
    time() + 3600,  // 1小时后过期
    "/",             // 根目录生效
    "",              // 无特定域名
    true,            // 仅HTTPS传输
    true             // 禁止JS读取
);

三、PHP中读取Cookie的方法

PHP通过超全局数组$_COOKIE读取Cookie，需先检查是否存在目标Cookie：

// 读取单个Cookie
if (isset($_COOKIE["user_id"])) {
    echo "用户ID：" . $_COOKIE["user_id"];
} else {
    echo "未找到用户ID Cookie";
}

// 读取所有Cookie
echo "<pre>";
print_r($_COOKIE);  // 输出所有Cookie数组
echo "</pre>";

四、PHP中删除Cookie的方法

删除Cookie需将过期时间设为过去的时间戳：

// 方法1：设置过期时间为1秒前
setcookie("user_id", "", time() - 1, "/", "", true, true);

// 方法2：直接删除（需与设置时参数一致）
setcookie("user_id", "", 0, "/", "", true, true);

五、Cookie的安全与注意事项

敏感信息禁止存储：Cookie内容可被用户查看，密码、银行卡号等敏感数据需加密后存储或使用Session。
安全属性配置：
- HttpOnly=true：防止JS通过document.cookie读取，降低XSS风险；
- Secure=true：仅在HTTPS协议下传输，避免明文泄露；
- SameSite=Strict：禁止跨域请求携带Cookie，防CSRF攻击；
- Path=/：限制Cookie仅在指定路径生效，减少被恶意站点窃取。
大小与数量限制：单个Cookie大小通常≤4KB，总Cookie数建议≤50个，过多会影响页面加载速度。

六、实战应用场景

1. 用户登录状态保持

// 登录成功后设置用户信息Cookie
if ($login_success) {
    setcookie("username", "testuser", time() + 86400 * 7, "/", "", true, true);
    setcookie("role", "admin", time() + 86400 * 7, "/", "", true, true);
    header("Location: dashboard.php");
}

2. 购物车临时存储

// 添加商品到购物车（假设已获取商品ID和数量）
$cart = $_COOKIE["cart"] ?? [];
$cart[$product_id] = ($cart[$product_id] ?? 0) + $quantity;
setcookie("cart", json_encode($cart), time() + 86400 * 30, "/", "", true, true);

七、常见问题与调试

Cookie不生效原因：
- 路径错误：如设置path="/admin"，访问/index.php时无法读取；
- 浏览器拦截：检查浏览器隐私设置是否禁止第三方Cookie；
- 未编码特殊字符：如Cookie值含中文需urlencode()，否则可能截断。
调试方法：
- 查看所有Cookie：print_r($_COOKIE);；
- 浏览器检查：F12打开开发者工具→Application→Storage→Cookies；
- 错误排查：使用setcookie()返回值判断是否设置成功（成功返回true，失败返回false）。

八、总结

PHP Cookie是实现用户状态管理的基础工具，合理使用可提升用户体验与系统性能。需注意其安全性与生命周期控制，结合HttpOnly、Secure等属性降低风险。在实际开发中，建议优先使用HTTPS，避免存储敏感数据，并通过$_COOKIE与setcookie()函数灵活处理用户交互数据，让Web应用更智能、更安全。