PHP setcookie() 函数
示例
以下示例创建了一个名为“user”的 cookie，其值为“John Doe”。 该 cookie 将在 30 天后过期 (86400 * 30)。“/” 表示 cookie 可在整个网站中使用（否则，请选择您喜欢的目录）。
然后我们检索 cookie “user” 的值（使用全局变量 $_COOKIE）。 我们还使用 isset() 函数来确定 cookie 是否已设置
<!DOCTYPE html>
<?php
$cookie_name = "user";
$cookie_value = "John Doe";
setcookie($cookie_name, $cookie_value, time() + (86400 * 30), "/"); // 86400 = 1 天
?>
<html>
<body>
<?php
if(!isset($_COOKIE[$cookie_name])) {
echo "名为 '" . $cookie_name . "' 的 cookie 未设置！";
} else {
echo "Cookie '" . $cookie_name . "' 已设置！<br>";
echo "值为：" . $_COOKIE[$cookie_name];
}
?>
</body>
</html>
自己试试 »
定义和用法
setcookie() 函数定义一个 cookie，该 cookie 将与其他 HTTP 标头一起发送。
cookie 通常用于识别用户。 cookie 是服务器嵌入用户计算机上的一个小文件。 每次同一台计算机使用浏览器请求页面时，它也会发送 cookie。 使用 PHP，您可以创建和检索 cookie 值。
cookie 的名称会自动分配给具有相同名称的变量。 例如，如果一个 cookie 的名称为“user”，那么会自动创建一个名为 $user 的变量，其中包含 cookie 的值。
注意： setcookie() 函数必须出现在 <html> 标记之前。
注意: 在发送 Cookie 时，Cookie 的值会自动进行 URL 编码，并在接收时自动解码（要防止 URL 编码，请使用 setrawcookie()）。
语法
setcookie(name, value, expire, path, domain, secure, httponly);
参数值
| 参数 | 描述 |
|---|---|
| name | 必需。指定 Cookie 的名称。 |
| value | 可选。指定 Cookie 的值。 |
| expire | 可选。指定 Cookie 的过期时间。例如：time()+86400*30，将设置 Cookie 在 30 天后过期。如果省略此参数或设置为 0，则 Cookie 将在会话结束时过期（关闭浏览器时）。默认值为 0。 |
| path | 可选。指定 Cookie 的服务器路径。如果设置为“/”，则 Cookie 将在整个域内可用。如果设置为“/php/”，则 Cookie 将仅在 php 目录及其所有子目录中可用。默认值为设置 Cookie 的当前目录。 |
| domain | 可选。指定 Cookie 的域名。要使 Cookie 在 example.com 的所有子域中可用，请将 domain 设置为“example.com”。将其设置为 www.example.com 将使 Cookie 仅在 www 子域中可用。 |
| secure | 可选。指定 Cookie 是否应仅通过安全的 HTTPS 连接传输。TRUE 表示仅在存在安全连接时才会设置 Cookie。默认值为 FALSE。 |
| httponly | 可选。如果设置为 TRUE，则 Cookie 只能通过 HTTP 协议访问（Cookie 将无法通过脚本语言访问）。此设置可以帮助减少通过 XSS 攻击造成的身份盗窃。默认值为 FALSE。 |
技术细节
| 返回值 | 成功时为 TRUE。失败时为 FALSE。 |
|---|---|
| PHP 版本 | 4+ |
| PHP 变更日志 | PHP 5.5 - 在发送到客户端的 Set-Cookie 标头中包含了 Max-Age 属性。 PHP 5.2 - 添加了 httponly 参数。 |
更多示例
示例
Cookie 的几个过期日期
<?php
$value = "Hello world!";
// Cookie 将在浏览器关闭时过期
setcookie("myCookie", $value);
// Cookie 将在 1 小时后过期
setcookie("myCookie", $value, time() + 3600);
// Cookie 将在 1 小时后过期，并且仅在
// php 目录及其所有子目录中可用
setcookie("myCookie", $value, time() + 3600, "/php/");
?>
<html>
<body>
...一些代码...
</body>
</html>
自己试试 »
示例
要修改 Cookie，只需使用 setcookie() 函数再次设置 Cookie。
<?php
$cookie_name = "user";
$cookie_value = "Alex Porter";
setcookie($cookie_name, $cookie_value, time() + (86400 * 30), "/");
?>
<html>
<body>
<?php
if(!isset($_COOKIE[$cookie_name])) {
echo "名为 '" . $cookie_name . "' 的 cookie 未设置！";
} else {
echo "Cookie '" . $cookie_name . "' 已设置！<br>";
echo "值为：" . $_COOKIE[$cookie_name];
}
?>
</body>
</html>
自己试试 »
示例
要删除 Cookie，请使用 setcookie() 函数，并将过期日期设置为过去。
<?php
// 将过期日期设置为 1 小时前
setcookie("user", "", time() - 3600);
?>
<html>
<body>
<?php
echo "Cookie 'user' 已删除。";
?>
</body>
</html>
自己试试 »
示例
创建一个检查 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>
自己试试 »
❮ PHP 网络参考
