setcookie() 定義一個(gè)和其余的 HTTP 標(biāo)頭一起發(fā)送的 cookie。和其它標(biāo)頭一樣，cookie 必須在腳本的任何其它輸出之前發(fā)送（這是協(xié)議限制）。這需要將本函數(shù)的調(diào)用放到任何輸出之前，包括 <html> 和 <head> 標(biāo)簽以及任何空格。如果在調(diào)用 setcookie() 之前有任何輸出，本函數(shù)將失敗并返回 FALSE。如果 setcookie() 函數(shù)成功運(yùn)行，將返回 TRUE。這并不說(shuō)明用戶是否接受了 cookie。
函數(shù)定義：
bool setcookie ( string name [, string value [, int expire [, string path [, string domain [, bool secure]]]]] )
setcookie() 參數(shù)詳解
|
參數(shù) |
說(shuō)明 |
舉例 |
|
name |
cookie的名字 |
使用 $_COOKIE['cookiename'] 調(diào)用名為 cookiename 的 cookie。 |
|
value |
cookie的值，存放在客戶端，不要存放敏感數(shù)據(jù) |
假定 name 是 'cookiename'，可以通過(guò)$_COOKIE['cookiename'] 取得其值。 |
|
expire |
Cookie 過(guò)期的時(shí)間。這是個(gè) Unix 時(shí)間戳，即從 Unix 紀(jì)元開始的秒數(shù)。 換而言之，通常用 time() 函數(shù)再加上秒數(shù)來(lái)設(shè)定 cookie 的失效期。 或者用mktime()來(lái)實(shí)現(xiàn)。 |
time()+60*60*24*30 將設(shè)定 cookie 30 天后失效。 如果未設(shè)定，cookie 將會(huì)在會(huì)話結(jié)束后（一般是瀏覽器關(guān)閉）失效。 |
|
path |
Cookie 在服務(wù)器端的有效路徑。 |
如果該參數(shù)設(shè)為 '/' 的話，cookie 就在整個(gè) domain 內(nèi)有效， 如果設(shè)為 '/foo/'，cookie 就只在 domain 下的 /foo/ 目錄及其子目錄內(nèi)有效，例如 /foo/bar/。 默認(rèn)值為設(shè)定 cookie 的當(dāng)前目錄。 |
|
domain |
該 cookie 有效的域名。 |
要使 cookie 能在如 example.com 域名下的所有子域都有效的話，該參數(shù)應(yīng)該設(shè)為 '.example.com'。 雖然 . 并不必須的，但加上它會(huì)兼容更多的瀏覽器。 如果該參數(shù)設(shè)為www.example.com 的話，就只在 www 子域內(nèi)有效。 細(xì)節(jié)見Cookie 規(guī)范中的 tail matching。 |
|
secure |
指明 cookie 是否僅通過(guò)安全的 HTTPS 連接傳送。 當(dāng)設(shè)成 TRUE 時(shí)，cookie 僅在安全的連接中被設(shè)置。默認(rèn)值為FALSE。 |
0 或 1 |
例子 1. setcookie() 發(fā)送例子
復(fù)制代碼 代碼如下:
$value = 'something from somewhere';
setcookie("TestCookie", $value);
setcookie("TestCookie", $value,time()+3600); /* expire in 1 hour */
setcookie("TestCookie", $value,time()+3600, "/~rasmus/", ".utoronto.ca", 1);
注意 cookie 中值的部分在發(fā)送的時(shí)候會(huì)被自動(dòng)用 urlencode 編碼并在接收到的時(shí)候被自動(dòng)解碼并把值賦給與自己同名的 cookie 變量。如果不想這樣并且在使用 PHP 5 的話，可以用 setrawcookie() 來(lái)代替。下面這個(gè)簡(jiǎn)單的例子可以得到剛才所設(shè)定的 cookie 的值：
復(fù)制代碼 代碼如下:
<?php
// 輸出單獨(dú)的 cookie
echo $_COOKIE["TestCookie"];
echo $HTTP_COOKIE_VARS["TestCookie"];
// 另一個(gè)調(diào)試的方法就是輸出所有的 cookie
print_r($_COOKIE);
?>
要?jiǎng)h除 cookie 需要確保它的失效期是在過(guò)去，才能觸發(fā)瀏覽器的刪除機(jī)制。下面的例子說(shuō)明了如何刪除剛才設(shè)置的 cookie：
例子 2. setcookie() 刪除例子
復(fù)制代碼 代碼如下:
// 將過(guò)期時(shí)間設(shè)為一小時(shí)前
setcookie("TestCookie", "", time() - 3600);
setcookie("TestCookie", "", time() - 3600, "/~rasmus/", ".utoronto.ca", 1);
也可以通過(guò)在 cookie 名稱中使用數(shù)組符號(hào)來(lái)設(shè)定數(shù)組 cookie，可以設(shè)定多個(gè) cookie 作為數(shù)組單元，在腳本提取 cookie 時(shí)所有的值都放在一個(gè)數(shù)組種：
例子 3. setcookie() 中使用數(shù)組的例子
復(fù)制代碼 代碼如下:
<?php
// 設(shè)定 cookie
setcookie("cookie[three]", "cookiethree");
setcookie("cookie[two]", "cookietwo");
setcookie("cookie[one]", "cookieone");
// 刷新頁(yè)面后，顯示出來(lái)
if (isset($_COOKIE['cookie'])) {
foreach ($_COOKIE['cookie'] as $name => $value) {
echo "$name : $value <br />\n";
}
}
?>
上例將輸出：
three : cookiethree
two : cookietwo
one : cookieone
總結(jié)：cookie的基本使用不難，這篇文章記錄的重點(diǎn)主要是掌握path的路徑設(shè)置和domain的域名設(shè)置。
