PHP setcookie() 函数（超详细）

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战(已更新的所有项目都能学习) / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

• 新开坑项目:《Spring AI 项目实战》 正在持续爆肝中，基于 Spring AI + Spring Boot 3.x + JDK 21...， 点击查看 ;
• 《从零手撸：仿小红书（微服务架构）》 已完结，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;演示链接： http://116.62.199.48:7070 ;
• 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 90w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 3100+ 小伙伴加入学习 ，欢迎点击围观

在 PHP 开发中，setcookie() 函数是管理用户会话和持久化数据的重要工具。无论是构建登录系统、个性化设置，还是实现购物车功能，setcookie() 函数都扮演着不可替代的角色。本文将从基础语法到实战案例，逐步解析如何正确使用 setcookie() 函数，并结合实际场景帮助读者掌握其核心逻辑。

一、Cookie 的基础概念与作用

1.1 什么是 Cookie？

Cookie 是一种由服务器发送到客户端（浏览器）的小型数据片段，通常用于记录用户的行为或偏好。例如，网站可能通过 Cookie 记住用户的登录状态，或保存购物车中的商品信息。

形象比喻：
可以把 Cookie 想象成餐厅提供的“点餐小票”。当你进入餐厅时，服务员会给你一张小票（Cookie），上面记录你点过的菜品和特殊需求。下次你再次光临时，服务员通过小票（Cookie）快速了解你的偏好，无需重新询问。

1.2 Cookie 与 Session 的区别

• Cookie：数据存储在客户端（浏览器），安全性较低，适合存储少量非敏感信息。
• Session：数据存储在服务器端，安全性更高，适合处理敏感信息（如用户密码）。

关键点：

• Cookie 的大小限制通常为 4KB，且每个域名下最多存储 20 个 Cookie。
• 浏览器会自动发送 Cookie 到服务器，无需额外代码触发。

二、setcookie() 函数的语法与参数详解

2.1 基础语法

PHP 中的 setcookie() 函数用于发送 Cookie 到客户端。其语法格式如下：

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

2.2 参数详解

2.3 参数使用示例

示例 1：设置一个临时 Cookie

// 设置名为 "username" 的 Cookie，值为 "john_doe"，有效期为临时（关闭浏览器失效）  
setcookie("username", "john_doe");  

示例 2：设置永久 Cookie

// 设置有效期为 30 天  
$expiration = time() + (86400 * 30);  
setcookie("user_preference", "dark_mode", $expiration);  

示例 3：指定路径和域名

// 仅在 "/admin" 路径下生效，并作用于所有子域名（如 blog.example.com）  
setcookie("admin_token", "xyz123", 0, "/admin", ".example.com");  

三、setcookie() 的常见问题与解决方案

3.1 为什么设置的 Cookie 没有生效？

原因：setcookie() 必须在任何输出（如 HTML、echo、print）之前调用。
解决方法：将 setcookie() 放在 PHP 文件的最顶部：

<?php  
// 正确做法：先设置 Cookie，再输出内容  
setcookie("test", "success");  
echo "Cookie 已设置！";  

// 错误做法：输出后设置 Cookie  
echo "错误示例！";  
setcookie("test", "error"); // 此处会触发警告  

3.2 如何删除一个 Cookie？

通过设置 expires 参数为过去的 Unix 时间戳：

// 删除名为 "user_token" 的 Cookie  
setcookie("user_token", "", time() - 3600, "/");  

3.3 如何处理多值 Cookie？

方法：使用 serialize() 或 json_encode() 将复杂数据序列化：

// 存储用户购物车数据  
$cart = array("product_id" => 101, "quantity" => 2);  
setcookie("shopping_cart", json_encode($cart), time() + 86400);  

四、进阶技巧与最佳实践

4.1 安全性设置

• 启用 httponly：防止 JavaScript 通过 document.cookie 访问敏感信息。

  setcookie("session_id", "abc123", time() + 3600, "/", null, true, true);  
  

• 使用 HTTPS：将 secure 参数设为 true，确保 Cookie 仅通过加密传输。

4.2 多 Cookie 管理

通过 $_COOKIE 超全局变量读取 Cookie：

// 检查用户是否已登录  
if (isset($_COOKIE["logged_in"])) {  
    echo "欢迎回来！";  
}  

五、实战案例：用户登录状态的持久化

案例 1：记住用户登录状态

// 登录成功后设置 Cookie  
$expiration = time() + (86400 * 30); // 有效期 30 天  
setcookie("user_id", $user_id, $expiration, "/", null, true, true);  

// 在其他页面验证登录状态  
if (isset($_COOKIE["user_id"])) {  
    $user_id = $_COOKIE["user_id"];  
    // 查询数据库验证用户  
}  

案例 2：实现“记住用户名”功能

// 用户提交表单时设置 Cookie  
if ($_SERVER["REQUEST_METHOD"] === "POST") {  
    $username = $_POST["username"];  
    $remember = $_POST["remember_me"]; // 值为 "1" 或空  
    if ($remember) {  
        setcookie("saved_username", $username, time() + (86400 * 30));  
    } else {  
        setcookie("saved_username", "", time() - 3600); // 删除 Cookie  
    }  
}  

// 在登录页面预填用户名  
$username_value = isset($_COOKIE["saved_username"]) ? $_COOKIE["saved_username"] : "";  
echo "<input type='text' name='username' value='{$username_value}'>";  

六、总结与展望

通过本文的讲解，读者应能掌握 setcookie() 函数的核心用法及常见场景的实现逻辑。以下是关键总结点：

1. 基础使用：设置 Cookie 需注意输出顺序和参数配置。
2. 安全性：通过 httponly 和 secure 参数防范攻击。
3. 实际应用：结合 $_COOKIE 变量实现登录状态、个性化设置等功能。

随着开发经验的积累，建议进一步探索 Cookie 的高级用法，例如与 Session 结合使用，或通过加密技术增强数据保护。掌握 setcookie() 函数，将为构建更复杂的应用程序奠定坚实基础。

希望本文能帮助开发者在 PHP 开发中更自信地使用 setcookie() 函数，实现高效、安全的会话管理。