PHP Cookie
关键要点
- Cookie 是服务器存储在用户浏览器中的小型数据，用于识别用户和保存信息。
- 在 PHP 中，可以通过
setcookie()函数创建 Cookie，使用$_COOKIE数组读取，并通过设置过期时间删除。 - 研究表明，Cookie 必须在输出任何内容之前设置，且不适合存储敏感信息。
Cookie 简介
Cookie 是什么？
Cookie 是服务器留在用户浏览器中的小型文本文件，用于保存用户信息（如登录状态或偏好设置）。当用户再次访问网站时，浏览器会将 Cookie 发送回服务器，帮助识别用户。
如何在 PHP 中使用 Cookie？
PHP 提供了简单的方法来创建、读取和删除 Cookie，适合初学者和开发者。
创建 Cookie
- 使用
setcookie()函数创建 Cookie，语法为：
setcookie(name, value, expire, path, domain, secure, httponly);- 示例：创建一个名为 “user” 的 Cookie，值为 “JohnDoe”，30 天后过期：
php setcookie("user", "JohnDoe", time() + (86400 * 30), "/"); - 注意：必须在任何输出（包括 HTML）之前调用。
读取 Cookie
- 使用
$_COOKIE数组读取 Cookie，例如：
if (isset($_COOKIE["user"])) {
echo $_COOKIE["user"];
}- 建议先用
isset()检查 Cookie 是否存在。
删除 Cookie
- 将 Cookie 的过期时间设置为过去，例如：
setcookie("user", "", time() - 3600);- 这会告诉浏览器删除 Cookie。
重要注意事项
setcookie()必须在输出任何内容之前调用。- Cookie 存储在客户端，可能被用户禁用或修改，不适合存储敏感信息。
- 每个 Cookie 最大大小通常为 4KB，每个域最多 20 个 Cookie。
详细报告：PHP Cookie 中文讲解
引言
Cookie 是 Web 开发中不可或缺的技术，用于在客户端浏览器中存储小型数据，帮助服务器识别用户并保存信息。在 PHP 中，Cookie 的操作非常灵活，可以通过 setcookie() 函数创建、$_COOKIE 数组读取，并通过设置过期时间删除。本报告基于 2025 年 7 月 15 日的在线资源（如菜鸟教程、PHP 官方手册和 W3School），提供了 PHP Cookie 的全面中文讲解，旨在帮助初学者和进阶开发者理解和掌握 Cookie 的使用。
背景与概述
Cookie 是 HTTP 协议的一部分，最初用于跟踪用户会话状态。在 PHP 中，Cookie 的支持是透明的，开发者可以通过内置函数轻松操作。研究表明，Cookie 常用于保存用户登录状态、购物车信息或浏览偏好，但由于存储在客户端，存在安全风险，不适合存储敏感数据。
Cookie 的工作原理
- 当用户访问网站时，服务器可以通过
setcookie()函数向用户的浏览器发送 Cookie。 - 浏览器将 Cookie 存储在本地，并在后续请求中将 Cookie 发送回服务器。
- 服务器通过 Cookie 识别用户，实现个性化功能。
PHP 中 Cookie 的详细用法
1. 创建 Cookie
- 函数：
setcookie() - 语法：
setcookie(name, value, expire, path, domain, secure, httponly);name：Cookie 的名称（必需）。value：Cookie 的值（必需）。expire：Cookie 的过期时间（Unix 时间戳，默认为会话结束时过期）。path：Cookie 的路径（默认为当前路径）。domain：Cookie 的域名（默认为当前域）。secure：是否仅在 HTTPS 连接中发送（默认为 FALSE）。httponly：是否仅允许 HTTP 协议访问（默认为 FALSE）。- 示例：
setcookie("user", "JohnDoe", time() + (86400 * 30), "/");time() + (86400 * 30)：计算 30 天后的 Unix 时间戳（86400 为一天的秒数）。- 注意：
setcookie()必须在任何输出（包括空格或 HTML）之前调用，否则会报错。
2. 读取 Cookie
- 方法： 使用
$_COOKIE超全局数组。 - 示例：
if (isset($_COOKIE["user"])) {
echo "Cookie 'user' 的值是：" . $_COOKIE["user"];
} else {
echo "Cookie 'user' 未设置！";
}- 注意： 使用
isset()检查 Cookie 是否存在，以避免未定义变量错误。 - 多值 Cookie： 如果需要设置多个值，可以使用数组形式，例如：
setcookie("cookie[one]", "value1");
setcookie("cookie[two]", "value2");- 读取时，
$_COOKIE["cookie"]["one"]可以获取 “value1″。
3. 删除 Cookie
- 方法： 将 Cookie 的过期时间设置为过去的时间。
- 示例：
setcookie("user", "", time() - 3600);time() - 3600：将过期时间设置为 1 小时前，浏览器会删除该 Cookie。- 注意： 删除时，保持其他参数（如 path、domain）与创建时一致。
4. 高级用法
- URL 编码： Cookie 的值会自动进行 URL 编码。如果不需要编码，可以使用
setrawcookie()。 - 检查浏览器是否支持 Cookie：
setcookie("test_cookie", "test", time() + 3600);
if (count($_COOKIE) > 0) {
echo "浏览器支持 Cookie";
} else {
echo "浏览器不支持 Cookie";
}- 修改 Cookie 值： 再次调用
setcookie()，只需更新值和过期时间，例如：
setcookie("user", "NewValue", time() + (86400 * 30), "/");注意事项与最佳实践
以下是使用 PHP Cookie 时需要注意的事项：
- 输出限制：
setcookie()必须在任何输出（包括空格或 HTML）之前调用，否则会因 HTTP 头已发送而失败。 - 安全性： Cookie 存储在客户端，可能被用户查看或修改，不适合存储敏感信息（如密码）。建议使用 HTTPS 并设置
httponly提高安全性。 - 大小限制： 研究表明，每个 Cookie 最大大小通常为 4KB，每个域最多可存储 20 个 Cookie，浏览器总共最多 300 个 Cookie。
- 浏览器支持： 用户可能禁用 Cookie，因此需要提供替代方案（如使用 Session）。可以通过表单提交或 URL 参数传递数据。
- 替代方案： 对于需要更安全和灵活的数据存储，建议使用 PHP 的 Session，Session 数据存储在服务器端，安全性更高。
工具对比表
以下是 Cookie 与 Session 的对比，方便开发者选择：
| 特性 | Cookie | Session |
|---|---|---|
| 存储位置 | 客户端浏览器 | 服务器端（通常存储在文件或数据库） |
| 安全性 | 较低，可能被篡改 | 较高，数据存储在服务器 |
| 容量限制 | 每个 Cookie 4KB，总共 300 个 | 受服务器资源限制，较大 |
| 过期时间 | 可设置，浏览器关闭后可能失效 | 通常依赖会话超时 |
| 使用场景 | 保存偏好设置、简单跟踪 | 用户登录状态、购物车等敏感数据 |
完整示例
以下是一个完整的示例，展示了创建、读取和删除 Cookie 的过程：
<?php
// 创建 Cookie
$cookie_name = "user";
$cookie_value = "JohnDoe";
setcookie($cookie_name, $cookie_value, time() + (86400 * 30), "/");
?>
<html>
<body>
<?php
// 读取 Cookie
if (isset($_COOKIE[$cookie_name])) {
echo "Cookie '" . $cookie_name . "' 已设置！<br>";
echo "值是：" . $_COOKIE[$cookie_name];
} else {
echo "Cookie '" . $cookie_name . "' 未设置！";
}
?>
</body>
</html>
<?php
// 删除 Cookie
setcookie($cookie_name, "", time() - 3600);
?>结论
PHP 中的 Cookie 提供了一种简单的方式来存储客户端数据，适合用于非敏感信息的保存。通过掌握 setcookie() 函数和 $_COOKIE 数组的使用，开发者可以轻松实现用户跟踪和状态保持。建议注意安全性限制，并根据需求选择 Session 等替代方案。