PHP setcookie() 函数

PHP HTTP Functions

定义和用法

setcookie() 函数向客户端发送一个 HTTP cookie。

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

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

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

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

语法

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 的值。

注释：在发送 cookie 时，cookie 的值会自动进行 URL 编码。接收时会进行 URL 解码。如果你不需要这样，可以使用 setrawcookie() 代替。

实例

例子 1

设置并发送 cookie：

<?php
$value = "my cookie value";
// 发送一个简单的 cookie
setcookie("TestCookie",$value);
?>
<html>
<body>
...
...

<?php
$value = "my cookie value";
// 发送一个 24 小时后过期的 cookie
setcookie("TestCookie",$value, time()+3600*24);
?>
<html>
<body>
...
...

例子 2

不同方法检索 cookie 值：

<html>
<body>
<?php
// 输出个别的 cookie
echo $_COOKIE["TestCookie"];
echo "<br />";
echo $HTTP_COOKIE_VARS["TestCookie"];
echo "<br />";
// Uitvoer alle cookies
print_r($_COOKIE);
?>
</body>
</html>

Uitvoer:

mijn cookie waarde
mijn cookie waarde
Array ([TestCookie] => mijn cookie waarde)

Voorbeeld 3

// Verwijder een cookie door de vervaldatum in te stellen op een verleden datum/tijd:

<?php
// Stel de vervaldatum in op een uur geleden
setcookie ("TestCookie", "", time() - 3600);
?>
<html>
<body>
...
...

Voorbeeld 4

Maak een array cookie aan:

<?php
setcookie("cookie[three]","cookiethree");
setcookie("cookie[two]","cookietwo");
setcookie("cookie[one]","cookieone");
// Uitvoer cookie (na het herladen van de pagina)
if (isset($_COOKIE["cookie"]))
  {
  foreach ($_COOKIE["cookie"] as $name => $value)
    {
    echo "$name : $value <br />";
    }
  }
?>
<html>
<body>
...
...

Uitvoer:

three : cookiethree
two : cookietwo
one : cookieone

PHP HTTP Functions