Php/func network setcookie
来自菜鸟教程
PHP setcookie()函数
例
下面的示例创建一个名为“ user”的cookie,其值为“ John Doe”。Cookie将在30天后过期(86400 * 30)。“ /”表示该cookie在整个网站上都可用(否则,请选择您喜欢的目录)。
然后,我们使用全局变量$ _COOKIE检索cookie“ user”的值。我们还使用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”,则会自动创建一个名为$ user的变量,其中包含cookie的值。
'注意:' setcookie()函数必须出现在<html>标记之前。
注意: Cookie的值在发送Cookie时会自动进行URL编码,并在接收时自动进行解码(为防止URLencoding,请使用 setrawcookie()
代替)。
句法
setcookie(name, value, expire, path, domain, secure, httponly);
参数值
| 参数 | 描述 |
|---|---|
| name | 需要。指定cookie的名称 |
| value | 可选的。指定cookie的值 |
| expire | 可选的。指定cookie何时过期。值:time()+ 86400 * 30,将cookie设置为在30天后过期。如果省略此参数或将其设置为0,则cookie将在会话结束时(浏览器关闭时)过期。默认为0 |
| path | 可选的。指定cookie的服务器路径。如果设置为“ /”,则cookie将在整个域中可用。如果设置为“ / php /”,则该cookie仅在php目录和php的所有子目录中可用。默认值为在其中设置cookie的当前目录 |
| domain | 可选的。指定cookie的域名。要使cookie在example.com的所有子域中都可用,请将domain设置为“ example.com”。将其设置为www.example.com将使该Cookie仅在www子域中可用 |
| secure | 可选的。指定是否仅应通过安全的HTTPS连接传输cookie。TRUE表示仅在存在安全连接时才设置cookie。默认为FALSE |
| httponly | 可选的。如果设置为TRUE,则只能通过HTTP协议访问cookie(无法通过脚本语言访问cookie)。此设置可以帮助减少通过XSS攻击造成的身份盗用。默认为FALSE |
技术细节
| 返回值: | 成功则为真。失败时为假 |
| PHP版本: | 4+ |
| PHP更新日志: | PHP 5.5-Max-Age属性包含在发送给客户端的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,只需使用setcookie()函数设置(再次)cookie:
<?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>
例
创建一个小的脚本,检查是否启用了cookie。首先,尝试使用setcookie()函数创建一个测试Cookie,然后计算$ _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>