例
下面的示例创建一个名为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参考