例
下面的示例創建一個名為cookie的"user"與價值"John Doe" 。 經過30天的cookie將過期(86400 * 30) 該"/"表示該cookie是在整個網站上提供(otherwise, select the directory you prefer) 。
然後,我們檢索cookie的值"user" (使用全局變量$ _COOKIE)。 我們還使用isset()的功能,以找出是否設置cookie:
<!DOCTYPE html>
<?php
$cookie_name = "user";
$cookie_value = "John
Doe";
setcookie($cookie_name, $cookie_value, time() + (86400 * 30), "/");
// 86400 = 1 day
?>
<html>
<body>
<?php
if(!isset($_COOKIE[$cookie_name]))
{
echo "Cookie named '" . $cookie_name . "' is not
set!";
} else {
echo "Cookie '" . $cookie_name
. "' is set!<br>";
echo "Value is: " . $_COOKIE[$cookie_name];
}
?>
</body>
</html>
運行示例» 定義和用法
的setcookie()函數定義要隨著HTTP頭的其餘部分發送cookie。
Cookie通常用來識別用戶。 Cookie是服務器在用戶的計算機中的小文件。 每當計算機請求一個頁面瀏覽器時,它就會發送cookie。 使用PHP,您可以創建並取回cookie的值。
Cookie的名字被自動分配到同一名稱的變量。 例如,如果一個cookie用的名稱發送"user" ,一個變量被自動創建名為$用戶,包含cookie值。
Note:該setcookie()函數必須出現在之前<html>標記。
Note:在發送cookie時cookie的值會自動url編碼,在接收時自動解碼(為防止URL編碼,使用setrawcookie()代替)。
句法
setcookie( name,value,expire,path,domain,secure,httponly );
參數 | 描述 |
---|---|
name | 需要。 指定cookie的名稱 |
value | 可選的。 指定cookie的值 |
expire | 可選的。 指定當Cookie過期。 值: time() + 86400 * 30,將設置Cookie在30天后過期。 如果省略或設置為0這個參數,cookie將在會話結束時終止(when the browser closes) 。 默認值為0 |
path | 可選的。 規定cookie的服務器路徑。 如果設置為"/"時,cookie將是整個域內可用。 如果設置為"/php/"時,cookie將只能是php目錄和PHP的所有子目錄中可用。 默認值是該Cookie在所設定的當前目錄 |
domain | 可選的。 規定cookie的域名。 為了使在example.com的所有子域提供的餅乾,設置域"example.com" 如果設置為www.example.com將會使餅乾只在www子域可用 |
secure | 可選的。 規定是否該cookie只能通過安全的HTTPS連接來傳輸。 TRUE表明,如果安全連接存在cookie將只設置。 默認為FALSE |
httponly | 可選的。 如果設置為TRUE,cookie將只能通過HTTP協議來訪問(the cookie will not be accessible by scripting languages) 。 此設置有助於通過XSS攻擊,以減少身份盜竊。 默認為FALSE |
技術細節
返回值: | TRUE成功。 FALSE失敗 |
---|---|
PHP版本: | 4+ |
PHP更新日誌: | PHP 5.5 - A最大年齡屬性包括在發送給客戶端的Set-Cookie頭 PHP 5.2 - 加中HTTPOnly參數 |
更多示例
例
一些到期日期的Cookie:
<?php
$value = "Hello world!";
// cookie will expire when the
browser close
setcookie("myCookie", $value);
// cookie will expire
in 1 hour
setcookie("myCookie", $value, time() + 3600);
// cookie
will expire in 1 hour, and will only be available
// within the php
directory + all sub-directories of php
setcookie("myCookie", $value,
time() + 3600, "/php/");
?>
<html>
<body>
...some code...
</body>
</html>
運行示例» 例
要修改一個cookie,只需將(again)使用該cookie setcookie()函數:
<?php
$cookie_name = "user";
$cookie_value = "Alex
Porter";
setcookie($cookie_name, $cookie_value, time() + (86400 * 30), "/");
?>
<html>
<body>
<?php
if(!isset($_COOKIE[$cookie_name]))
{
echo "Cookie named '" . $cookie_name . "' is not
set!";
} else {
echo "Cookie '" . $cookie_name
. "' is set!<br>";
echo "Value is: " . $_COOKIE[$cookie_name];
}
?>
</body>
</html>
運行示例» 例
要刪除Cookie,使用setcookie()的功能與過去的到期日期:
<?php
// set the expiration date to one hour ago
setcookie("user",
"" , time() - 3600);
?>
<html>
<body>
<?php
echo "Cookie 'user'
is deleted.";
?>
</body>
</html>
運行示例» 例
創建一個小的腳本來檢查是否cookies被啟用。 首先,嘗試創建一個測試Cookie與setcookie()的功能,再算上$ _COOKIE數組變量:
<?php
setcookie("test_cookie", "test" , time() + 3600, '/');
?>
<html>
<body>
<?php
if(count($_COOKIE) > 0) {
echo "Cookies are enabled.";
} else {
echo "Cookies
are disabled.";
}
?>
</body>
</html>
運行示例» <PHP HTTP參考