PHP setrawcookie() 函数

定义和用法

setrawcookie() 函数不对 cookie 值进行 URL 编码,发送一个 HTTP cookie。

cookie 是由服务器发送到浏览器的变量。cookie 通常是服务器嵌入到用户计算机中的小文本文件。每当计算机通过浏览器请求一个页面,就会发送这个 cookie。

cookie 的名称指定为相同名称的变量。例如,如果被发送的 cookie 名为 "name",会自动创建名为 $user 的变量,包含 cookie 的值。

必须在任何其他输出发送前对 cookie 进行赋值。

如果成功,则该函数返回 true,否则返回 false。

语法

  1. setcookie(name,value,expire,path,domain,secure)
参数 描述
name 必需。规定 cookie 的名称。
value 必需。规定 cookie 的值。
expire 可选。规定 cookie 的有效期。
path 可选。规定 cookie 的服务器路径。
domain 可选。规定 cookie 的域名。
secure 可选。规定是否通过安全的 HTTPS 连接来传输 cookie。

提示和注释

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

注释:setrawcookie() 与 setcookie() 几乎完全相同,不同的是不会在发往客户机时,对 cookie 值进行自动 URL 编码。

例子

例子 1

设置并发送 cookie:

  1. <?php
  2. $value = "my cookie value";
  3.  
  4. // 发送一个简单的 cookie
  5. setrawcookie("TestCookie",$value);
  6. ?>
  7.  
  8. <html>
  9. <body>
  10.  
  11. ...
  12. ...
  1. <?php
  2. $value = "my cookie value";
  3.  
  4. // 发送一个 24 小时候过期的 cookie
  5. setrawcookie("TestCookie",$value, time()+3600*24);
  6. ?>
  7.  
  8. <html>
  9. <body>
  10.  
  11. ...
  12. ...

例子 2

检索 cookie 值的不同方法:

  1. <html>
  2. <body>
  3.  
  4. <?php
  5.  
  6. // 输出个别的 cookie
  7. echo $_COOKIE["TestCookie"];
  8. echo "<br />";
  9. echo $HTTP_COOKIE_VARS["TestCookie"];
  10. echo "<br />";
  11.  
  12. // 输出所有 cookie
  13. print_r($_COOKIE);
  14. ?>
  15.  
  16. </body>
  17. </html>

输出:

  1. my cookie value
  2. my cookie value
  3. Array ([TestCookie] => my cookie value)

例子 3

通过把失效日期设置为过去的日期/时间,删除一个 cookie:

  1. <?php
  2. // 把失效日期设置为一小时前
  3. setrawcookie ("TestCookie", "", time() - 3600);
  4. ?>
  5.  
  6. <html>
  7. <body>
  8.  
  9. ...
  10. ...

例子 4

创建一个数组 cookie:

  1. <?php
  2. setrawcookie("cookie[three]","cookiethree");
  3. setrawcookie("cookie[two]","cookietwo");
  4. setrawcookie("cookie[one]","cookieone");
  5.  
  6. // 输出 cookie (在重载页面后)
  7. if (isset($_COOKIE["cookie"]))
  8. {
  9. foreach ($_COOKIE["cookie"] as $name => $value)
  10. {
  11. echo "$name : $value <br />";
  12. }
  13. }
  14. ?>
  15.  
  16. <html>
  17. <body>
  18.  
  19. ...
  20. ...

输出:

  1. three : cookiethree
  2. two : cookietwo
  3. one : cookieone