PHP setrawcookie() 函数 - PHP 5 函数参考手册

PHP setrawcookie() 函数用于发送一个 HTTP cookie，且不对 cookie 值进行 URL 编码

函数原型

setrawcookie(name,value,expire,path,domain,secure)

cookie 是由服务器发送到浏览器的变量

cookie 通常是服务器嵌入到用户计算机中的小文本文件

每当同一台计算机通过浏览器请求页面时，就会发送这个 cookie

cookie 的名称自动指定为相同名称的变量

例如，如果被发送的 cookie 名为 "user"，则会自动创建一个名为 $user 的变量，包含 cookie 的值

必须在任何其它输出发送到客户端前对 cookie 进行赋值

PHP 可以通过 $HTTP_COOKIE_VARS["user"] 或 $_COOKIE["user"] 来访问名为 "user" 的 cookie 的值

setrawcookie() 函数与 setcookie() 函数几乎完全相同，不同的是不会在发往客户端时，对 cookie 值进行自动 URL 编码

参数

参数	描述
name	必需。规定 cookie 的名称
value	必需。规定 cookie 的值
expire	可选。规定 cookie 的过期时间 time()+36002430 将设置 cookie 的过期时间为 30 天如果这个参数没有设置，那么 cookie 将在 session 结束后（即浏览器关闭时）自动失效
path	可选。规定 cookie 的服务器路径如果设置为 "/"，那么 cookie 将在整个域名内有效如果设置为 "/test/"，那么 cookie 在 test 目录下及其所有子目录下有效默认的值是 cookie 所处的当前目录
domain	可选。规定 cookie 的域名为了让 cookie 在 example.com 的所有子域名中有效，需要设置为 ".example.com" 如果设置为 www.example.com 时，cookie 仅在 www 子域名中有效
secure	可选。规定是否需要在安全的 HTTPS 连接来传输 cookie 如果 cookie 需要在安全的 HTTPS 连接下传输，则设置为 TRUE 默认是 FALSE

返回值

如果成功，返回 TRUE
如果失败，则返回 FALSE

范例

下面的范例设置并发送 cookie

<?php

$value = "my cookie value";

// send a simple cookie
setrawcookie("estCookie",$value);
?>
<!DOCTYPE html>
<meta charset="utf-8"/>
<h1>简单教程,简单编程</h1>

下面的代码设置 cookie 24 小时后过期

<?php

$value = "my cookie value";

// send a cookie that expires in 24 hours

setrawcookie("TestCookie",$value, time()+3600*24);
?>
<!DOCTYPE html>
<meta charset="utf-8"/>
<h1>简单教程,简单编程</h1>

下面的范例演示了如何检索 cookie 值的不同方法（在 cookie 设置之后）

<!DOCTYPE html>
<meta charset="utf-8"/>
<h1>简单教程,简单编程</h1>
<?php

// Print individual cookies
echo $_COOKIE["TestCookie"];
echo "<br />";
echo $HTTP_COOKIE_VARS["TestCookie"];
echo "<br />";

// Print all cookies
print_r($_COOKIE);
?>

运行上面的 PHP 代码，输出结果如下

简单教程,简单编程
my cookie valuemy cookie valueArray ([TestCookie] => my cookie value)

下面的代码通过把失效日期设置为过去的日期/时间，删除一个 cookie

<?php

// Set the expiration date to one hour ago

setrawcookie ("TestCookie", "", time() - 3600);
?>
<!DOCTYPE html>
<meta charset="utf-8"/>
<h1>简单教程,简单编程</h1>

下面的范例创建了一个数组 cookie

<?php

setrawcookie("cookie[three]","cookiethree");
setrawcookie("cookie[two]","cookietwo");
setrawcookie("cookie[one]","cookieone");

// print cookies (after reloading page)

if (isset($_COOKIE["cookie"]))
{
    foreach ($_COOKIE["cookie"] as $name => $value)
    {
        echo "$name : $value <br />";
    }
}
?>
<!DOCTYPE html>
<meta charset="utf-8"/>
<h1>简单教程,简单编程</h1>

运行上面的范例，输出结果如下

简单教程,简单编程
three : cookiethree
two : cookietwo
one : cookieone