PHP setrawcookie() 函数
示例
以下示例使用 PHP 创建一个 cookie。cookie 的名称为“user”,其值为“John Doe”。cookie 值将不会被 URL 编码。cookie 将在 30 天后过期(86400 * 30)。使用“/”表示 cookie 在整个网站中可用(否则,选择您喜欢的目录)
<?php
$cookie_name = "user";
$cookie_value = "John";
setrawcookie($cookie_name, $cookie_value, time() + (86400 * 30), "/");
// 86400 = 1 天
?>
<html>
<body>
<?php
echo "Cookie 已设置。";
?>
</body>
</html>
?>
尝试一下 »
定义和用法
setrawcookie() 函数定义一个 cookie(不进行 URL 编码),以便与其他 HTTP 标头一起发送。
cookie 通常用于识别用户。cookie 是服务器嵌入到用户计算机上的一个小文件。每次同一台计算机使用浏览器请求页面时,它也会发送 cookie。使用 PHP,您可以创建和检索 cookie 值。
cookie 的名称会自动分配给一个同名的变量。例如,如果发送了一个名为“user”的 cookie,则会自动创建一个名为 $user 的变量,其中包含 cookie 值。
注意: setrawcookie() 函数必须出现在 <html> 标签之前。
注意: 要在发送时自动 URL 编码 cookie 值,并在接收时自动解码,请使用 setcookie() 函数。
语法
setrawcookie(name, value, expire, path, domain, secure);
参数值
参数 | 描述 |
---|---|
name | 必需。指定 cookie 的名称 |
value | 可选。指定 cookie 的值 |
expire | 可选。指定 cookie 过期时间。值:time()+86400*30,将设置 cookie 在 30 天后过期。如果未设置此参数,则 cookie 会在会话结束时过期(浏览器关闭时) |
path | 可选。指定 cookie 的服务器路径。如果设置为“/”,则 cookie 将在整个域中可用。如果设置为“/php/”,则 cookie 仅在 php 目录及其所有子目录中可用。默认值为设置 cookie 的当前目录。 |
域 | 可选。指定 cookie 的域名。要使 cookie 在 example.com 的所有子域中可用,请将域设置为“.example.com”。将其设置为 www.example.com 将使 cookie 仅在 www 子域中可用。 |
安全 | 可选。指定 cookie 是否应该仅通过安全的 HTTPS 连接传输。TRUE 表示仅在存在安全连接的情况下才会设置 cookie。默认值为 FALSE。 |
技术细节
返回值 | 成功时为 TRUE。失败时为 FALSE |
---|---|
PHP 版本 | 5+ |
更多示例
示例
检索名为“user”的 cookie 的值(使用全局变量 $_COOKIE)。还可以使用 isset() 函数来确定 cookie 是否存在。
<html>
<body>
<?php
$cookie_name = "user";
if(!isset($_COOKIE[$cookie_name])) {
echo "名为 '" . $cookie_name . "' 的 cookie 不存在!";
} else {
echo "Cookie 名称为:" . $cookie_name . "<br>值为:" . $_COOKIE[$cookie_name];
}
?>
</body>
</html>
尝试一下 »
示例
要修改 cookie,只需使用 setrawcookie() 函数重新设置 cookie。
<?php
$cookie_name = "user";
$cookie_value = "Alex";
setrawcookie($cookie_name, $cookie_value, time() + (86400 * 30), "/");
?>
<html>
<body>
<?php
$cookie_name = "user";
if(!isset($_COOKIE[$cookie_name])) {
echo "名为 '" . $cookie_name . "' 的 cookie 不存在!";
} else {
echo "Cookie 名称为:" . $cookie_name . "<br>值为:" . $_COOKIE[$cookie_name];
}
?>
</body>
</html>
尝试一下 »
示例
要删除 cookie,请使用 setrawcookie() 函数,其过期日期为过去。
<?php
$cookie_name = "user";
unset($_COOKIE[$cookie_name]);
// 空值和过期时间比当前时间早一个小时
$res = setrawcookie($cookie_name, '', time() - 3600);
?>
<html>
<body>
<?php
echo "Cookie 'user' 已删除。";
?>
</body>
</html>
尝试一下 »
示例
创建一个小型脚本,用于检查 cookie 是否已启用。首先,尝试使用 setrawcookie() 函数创建测试 cookie,然后计算 $_COOKIE 数组变量。
<?php
setrawcookie("test_cookie", "test", time() + 3600, '/');
?>
<html>
<body>
<?php
if(count($_COOKIE) > 0) {
echo "已启用 cookie";
} else {
echo "已禁用 cookie";
}
?>
</body>
</html>
尝试一下 »
❮ PHP 网络参考