快捷導(dǎo)航

php setcookie(name, value, expires, path, domain, secure) 參數(shù)詳解

更新時(shí)間：2013年06月28日 18:28:56 作者：

本篇文章是對php setcookie(name, value, expires, path, domain, secure) 參數(shù)進(jìn)行了詳細(xì)的分析介紹，需要的朋友參考下

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。這并不說明用戶是否接受了 cookie。
函數(shù)定義：
bool setcookie ( string name [, string value [, int expire [, string path [, string domain [, bool secure]]]]] )
setcookie() 參數(shù)詳解

參數(shù)	說明	舉例
name	cookie的名字	使用 `$_COOKIE['cookiename']` 調(diào)用名為 cookiename 的 cookie。
value	cookie的值，存放在客戶端，不要存放敏感數(shù)據(jù)	假定 `name` 是 'cookiename'，可以通過`$_COOKIE['cookiename']` 取得其值。
expire	Cookie 過期的時(shí)間。這是個(gè) Unix 時(shí)間戳，即從 Unix 紀(jì)元開始的秒數(shù)?！　?/SPAN> 換而言之，通常用 time() 函數(shù)再加上秒數(shù)來設(shè)定 cookie 的失效期。或者用mktime()來實(shí)現(xiàn)。	`time()+606024*30` 將設(shè)定 cookie 30 天后失效。如果未設(shè)定，cookie 將會在會話結(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'`。雖然 `.` 并不必須的，但加上它會兼容更多的瀏覽器。如果該參數(shù)設(shè)為`www.example.com` 的話，就只在 `www` 子域內(nèi)有效。細(xì)節(jié)見Cookie 規(guī)范中的 tail matching。
secure	指明 cookie 是否僅通過安全的 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í)候會被自動用 urlencode 編碼并在接收到的時(shí)候被自動解碼并把值賦給與自己同名的 cookie 變量。如果不想這樣并且在使用 PHP 5 的話，可以用 setrawcookie() 來代替。下面這個(gè)簡單的例子可以得到剛才所設(shè)定的 cookie 的值：

復(fù)制代碼代碼如下:

<?php
// 輸出單獨(dú)的 cookie
echo $_COOKIE["TestCookie"];
echo $HTTP_COOKIE_VARS["TestCookie"];
// 另一個(gè)調(diào)試的方法就是輸出所有的 cookie
print_r($_COOKIE);
?>

要刪除 cookie 需要確保它的失效期是在過去，才能觸發(fā)瀏覽器的刪除機(jī)制。下面的例子說明了如何刪除剛才設(shè)置的 cookie：
例子 2. setcookie() 刪除例子

復(fù)制代碼代碼如下:

// 將過期時(shí)間設(shè)為一小時(shí)前
setcookie("TestCookie", "", time() - 3600);
setcookie("TestCookie", "", time() - 3600, "/~rasmus/", ".utoronto.ca", 1);  

也可以通過在 cookie 名稱中使用數(shù)組符號來設(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");
// 刷新頁面后，顯示出來
if (isset($_COOKIE['cookie'])) {
    foreach ($_COOKIE['cookie'] as $name => $value) {
        echo "$name : $value <br />\n";
    }
}
?>