PHP setcookie() 函數(shù)
定義和用法
setcookie() 函數(shù)向客戶(hù)端發(fā)送一個(gè) HTTP cookie。
cookie 是由服務(wù)器發(fā)送到瀏覽器的變量。cookie 通常是服務(wù)器嵌入到用戶(hù)計(jì)算機(jī)中的小文本文件。每當(dāng)計(jì)算機(jī)通過(guò)瀏覽器請(qǐng)求一個(gè)頁(yè)面，就會(huì)發(fā)送這個(gè) cookie。
cookie 的名稱(chēng)指定為相同名稱(chēng)的變量。例如，如果被發(fā)送的 cookie 名為 "name"，會(huì)自動(dòng)創(chuàng)建名為 $user 的變量，包含 cookie 的值。
必須在任何其他輸出發(fā)送前對(duì) cookie 進(jìn)行賦值。
如果成功，則該函數(shù)返回 true，否則返回 false。
語(yǔ)法
setcookie(name,value,expire,path,domain,secure)
| 參數(shù) | 描述 |
|---|---|
| name | 必需。規(guī)定 cookie 的名稱(chēng)。 |
| value | 必需。規(guī)定 cookie 的值。 |
| expire | 可選。規(guī)定 cookie 的有效期。 |
| path | 可選。規(guī)定 cookie 的服務(wù)器路徑。 |
| domain | 可選。規(guī)定 cookie 的域名。 |
| secure | 可選。規(guī)定是否通過(guò)安全的 HTTPS 連接來(lái)傳輸 cookie。 |
提示和注釋
注釋?zhuān)?/span>可以通過(guò) $HTTP_COOKIE_VARS["user"] 或 $_COOKIE["user"] 來(lái)訪問(wèn)名為 "user" 的 cookie 的值。
注釋?zhuān)?/span>在發(fā)送 cookie 時(shí)，cookie 的值會(huì)自動(dòng)進(jìn)行 URL 編碼。接收時(shí)會(huì)進(jìn)行 URL 解碼。如果你不需要這樣，可以使用 setrawcookie() 代替。
例子
例子 1
設(shè)置并發(fā)送 cookie：
<?php
$value = "my cookie value";
// 發(fā)送一個(gè)簡(jiǎn)單的 cookie
setcookie("TestCookie",$value);
?>
<html>
<body>
...
...
<?php
$value = "my cookie value";
// 發(fā)送一個(gè) 24 小時(shí)候過(guò)期的 cookie
setcookie("TestCookie",$value, time()+3600*24);
?>
<html>
<body>
...
...
例子 2
檢索 cookie 值的不同方法：
<html> <body> <?php // 輸出個(gè)別的 cookie echo $_COOKIE["TestCookie"]; echo "<br />"; echo $HTTP_COOKIE_VARS["TestCookie"]; echo "<br />"; // 輸出所有 cookie print_r($_COOKIE); ?> </body> </html>
輸出：
my cookie value my cookie value Array ([TestCookie] => my cookie value)
例子 3
通過(guò)把失效日期設(shè)置為過(guò)去的日期/時(shí)間，刪除一個(gè) cookie：
<?php
// 把失效日期設(shè)置為一小時(shí)前
setcookie ("TestCookie", "", time() - 3600);
?>
<html>
<body>
...
...
例子 4
創(chuàng)建一個(gè)數(shù)組 cookie：
<?php
setcookie("cookie[three]","cookiethree");
setcookie("cookie[two]","cookietwo");
setcookie("cookie[one]","cookieone");
// 輸出 cookie （在重載頁(yè)面后）
if (isset($_COOKIE["cookie"]))
{
foreach ($_COOKIE["cookie"] as $name => $value)
{
echo "$name : $value <br />";
}
}
?>
<html>
<body>
...
...
輸出：
three : cookiethree two : cookietwo one : cookieone