PHP setrawcookie() 函数

PHP Network 函数

定义和用法

setrawcookie() 函数用于定义未经 URL 编码的 cookie，该 cookie 将随其他 HTTP 标头一起发送。

cookie 常用于识别用户。cookie 是服务器嵌入到用户计算机上的一个小文件。每当同一台计算机通过浏览器请求页面时，它都会发送该 cookie。使用 PHP，你可以创建和检索 cookie 值。

cookie 的名称会自动分配给同名的变量。例如，如果发送了一个名为 "user" 的 cookie，则会自动创建一个名为 $user 的变量，其中包含 cookie 的值。

注意：setrawcookie() 函数必须出现在 <html> 标签之前。

注意：若要在发送时自动对 cookie 值进行 URL 编码，并在接收时自动解码，请使用 setcookie() 函数。

实例

例子 1

下例使用 PHP 创建一个名为 "user" 的 cookie，其值为 "Bill Gates"。此 cookie 的值不会进行 URL 编码。此 cookie 将在 30 天后过期（86400 * 30）。使用 "/" 表示该 cookie 可在整个网站中使用（否则，请选择你偏好的目录）：

<?php
$cookie_name = "user";
$cookie_value = "Bill Gates";
setrawcookie($cookie_name, $cookie_value, time() + (86400 * 30), "/");
// 86400 = 1 day
?>
<html>
<body>

<?php
echo "Cookie 已设置。";
?>

</body>
</html>
?>

亲自试一试

例子 2

检索名为 "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>

亲自试一试

例子 3

要修改 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>

亲自试一试

例子 4

要删除 cookie，请使用带有过去过期日期的 setrawcookie() 函数：

<?php
$cookie_name = "user";
unset($_COOKIE[$cookie_name]);
// 空值，过期时间为一小时前
$res = setrawcookie($cookie_name, '', time() - 3600);
?>
<html>
<body>

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

</body>
</html>

亲自试一试

例子 5

创建一个小脚本来检查 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>

亲自试一试

语法

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 的当前目录。
domain

可选。指定 cookie 的域名。

若要使 cookie 在 example.com 的所有子域中都可用，请将 domain 设置为 ".example.com"。

将其设置为 "www.example.com" 将使 cookie 仅在 www 子域中可用。
secure

可选。指定是否仅通过安全的 HTTPS 连接传输 cookie。

TRUE 表示仅当存在安全连接时才设置 cookie。默认值为 FALSE。

技术细节

返回值： 成功时返回 TRUE，失败时返回 FALSE。
PHP 版本： 5+

PHP Network 函数