PHP Cookie

Begindev 编辑部 April 2, 2026

1. 什么是 Cookie？

Cookie 常用于识别用户。它是服务器嵌入到用户计算机中的一个小文件。每当同一台计算机通过浏览器请求页面时，它都会发送该 Cookie。

通过 PHP，您既可以创建 Cookie，也可以检索 Cookie 的值。

2. 在 PHP 中创建/修改 Cookie

在 PHP 中，使用 setcookie() 函数来创建一个 Cookie。

setcookie() 函数必须位于 <html> 标签之前。

2.1 语法

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

参数	描述
name	必填。规定 Cookie 的名称。
value	可选。规定 Cookie 的值。
expire	可选。规定 Cookie 的有效期（Unix 时间戳）。
path	可选。规定 Cookie 的服务器路径。
domain	可选。规定 Cookie 的域名。
secure	可选。规定是否仅通过安全的 HTTPS 连接传输。
httponly	可选。若为 TRUE，则脚本无法访问 Cookie（有效防止 XSS 攻击）。

2.2 创建/检索 Cookie 示例

下例创建了一个名为 "user" 的 Cookie，值为 "Alex Porter"，有效期为 30 天（86400 * 30 秒）。"/" 表示该 Cookie 在整个网站内可用（否则，您可以指定特定的目录）。

我们随后使用超全局变量 $_COOKIE 检索 Cookie 的值。同时使用 isset() 函数来检查 Cookie 是否已被设置：

代码示例：

<?php
$cookie_name = "user";
$cookie_value = "Alex Porter";
setcookie($cookie_name, $cookie_value, time() + (86400 * 30), "/"); // 86400 = 1 天
?>
<html>
<body>

<?php
if(!isset($_COOKIE[$cookie_name])) {
  echo "Cookie 名称 '" . $cookie_name . "' 尚未设置！";
} else {
  echo "Cookie '" . $cookie_name . "' 已设置！<br>";
  echo "值是: " . $_COOKIE[$cookie_name];
}
?>

</body>
</html>

注意：setcookie() 函数在发送 Cookie 时会自动对值进行 URL 编码，并在检索时自动解码。如果不希望进行编码，请改用 setrawcookie()。

3. 修改 Cookie 值

要修改 Cookie，只需使用 setcookie() 函数再次设置该 Cookie 即可：

代码示例：

<?php
$cookie_name = "user";
$cookie_value = "John Doe";
setcookie($cookie_name, $cookie_value, time() + (86400 * 30), "/");
?>
<html>
<body>

<?php
if(!isset($_COOKIE[$cookie_name])) {
  echo "Cookie 名称 '" . $cookie_name . "' 尚未设置！";
} else {
  echo "Cookie '" . $cookie_name . "' 已设置！<br>";
  echo "值是: " . $_COOKIE[$cookie_name];
}
?>

</body>
</html>

4. 删除 Cookie

要删除 Cookie，请使用 setcookie() 函数并将过期日期设置为过去的时间点：

代码示例：

<?php
// 将过期时间设置为一小时前
setcookie("user", "", time() - 3600);
?>
<html>
<body>

<?php
echo "Cookie 'user' 已被删除。";
?>

</body>
</html>

5. 检查 Cookie 是否已启用

下例创建了一个简短的脚本，用以检查浏览器是否启用了 Cookie。首先，尝试使用 setcookie() 创建一个测试 Cookie，然后对 $_COOKIE 数组变量进行计数：

代码示例：

<?php
setcookie("test_cookie", "test", time() + 3600, '/');
?>
<html>
<body>

<?php
if(count($_COOKIE) > 0) {
  echo "Cookie 已启用。";
} else {
  echo "Cookie 已禁用。";
}
?>

</body>
</html>