定义和用法
setcookie() 函数向客户端发送一个 HTTP cookie。
cookie 是由服务器发送到浏览器的变量。cookie 通常是服务器嵌入到用户计算机中的小文本文件。每当计算机通过浏览器请求一个页面,就会发送这个 cookie。
cookie 的名称指定为相同名称的变量。例如,如果被发送的 cookie 名为 "name",会自动创建名为 $user 的变量,包含 cookie 的值。
必须在任何其他输出发送前对 cookie 进行赋值。
如果成功,则该函数返回 true,否则返回 false。
语法
setcookie
(name
,
value
,
expire
,
path
,
domain
,
secure)
参数 | 描述 |
---|---|
name | 必需。规定 cookie 的名称。 |
value | 必需。规定 cookie 的值。 |
expire | 可选。规定 cookie 的有效期。 |
path | 可选。规定 cookie 的服务器路径。 |
domain | 可选。规定 cookie 的域名。 |
secure | 可选。规定是否通过安全的 HTTPS 连接来传输 cookie。 |
提示和注释
注释:可以通过 $HTTP_COOKIE_VARS["user"] 或 $_COOKIE["user"] 来访问名为 "user" 的 cookie 的值。
注释:在发送 cookie 时,cookie 的值会自动进行 URL 编码。接收时会进行 URL 解码。如果你不需要这样,可以使用 setrawcookie() 代替。
例子
例子 1
设置并发送 cookie:
<?
php
$value = " my cookie value " ;
// 发送一个简单的 cookie
setcookie ( " TestCookie " , $value );
?>
$value = " my cookie value " ;
// 发送一个简单的 cookie
setcookie ( " TestCookie " , $value );
?>
<
html
>
< body >
...
...
<? php
$value = " my cookie value " ;
// 发送一个 24 小时候过期的 cookie
setcookie ( " TestCookie " , $value , time () + 3600 * 24 );
?>
< html >
< body >
< body >
...
...
<? php
$value = " my cookie value " ;
// 发送一个 24 小时候过期的 cookie
setcookie ( " TestCookie " , $value , time () + 3600 * 24 );
?>
< html >
< body >
例子 2
检索 cookie 值的不同方法:
代码
<
html
>
< body >
<? php
// 输出个别的 cookie
echo $_COOKIE [ " TestCookie " ];
echo " <br /> " ;
echo $HTTP_COOKIE_VARS [ " TestCookie " ];
echo " <br /> " ;
// 输出所有 cookie
print_r ( $_COOKIE );
?>
</ body >
</ html >
< body >
<? php
// 输出个别的 cookie
echo $_COOKIE [ " TestCookie " ];
echo " <br /> " ;
echo $HTTP_COOKIE_VARS [ " TestCookie " ];
echo " <br /> " ;
// 输出所有 cookie
print_r ( $_COOKIE );
?>
</ body >
</ html >
输出:
my cookie value
my cookie value
Array ([TestCookie] => my cookie value)
my cookie value
Array ([TestCookie] => my cookie value)
例子 3
通过把失效日期设置为过去的日期/时间,删除一个 cookie:
<?
php
// 把失效日期设置为一小时前
setcookie ( " TestCookie " , "" , time () - 3600 );
?>
< html >
< body >
// 把失效日期设置为一小时前
setcookie ( " TestCookie " , "" , time () - 3600 );
?>
< html >
< body >
例子 4
创建一个数组 cookie:
代码
<?
php
setcookie ( " cookie[three] " , " cookiethree " );
setcookie ( " cookie[two] " , " cookietwo " );
setcookie ( " cookie[one] " , " cookieone " );
// 输出 cookie (在重载页面后)
if ( isset ( $_COOKIE [ " cookie " ]))
{
foreach ( $_COOKIE [ " cookie " ] as $name => $value )
{
echo " $name : $value <br /> " ;
}
}
?>
< html >
< body >
setcookie ( " cookie[three] " , " cookiethree " );
setcookie ( " cookie[two] " , " cookietwo " );
setcookie ( " cookie[one] " , " cookieone " );
// 输出 cookie (在重载页面后)
if ( isset ( $_COOKIE [ " cookie " ]))
{
foreach ( $_COOKIE [ " cookie " ] as $name => $value )
{
echo " $name : $value <br /> " ;
}
}
?>
< html >
< body >
... ...
输出:
three
:
cookiethree
two : cookietwo
one : cookieone
two : cookietwo
one : cookieone
康盛产品中的应用:
代码
/*
*
* 01.cookie设置
* */
function ssetcookie( $var , $value , $life = 0 ) {
global $_SGLOBAL , $_SC , $_SERVER ;
setcookie ( $_SC [ ' cookiepre ' ] . $var , $value , $life ? ( $_SGLOBAL [ ' timestamp ' ] + $life ) : 0 , $_SC [ ' cookiepath ' ] , $_SC [ ' cookiedomain ' ] , $_SERVER [ ' SERVER_PORT ' ] == 443 ? 1 : 0 );
}
* 01.cookie设置
* */
function ssetcookie( $var , $value , $life = 0 ) {
global $_SGLOBAL , $_SC , $_SERVER ;
setcookie ( $_SC [ ' cookiepre ' ] . $var , $value , $life ? ( $_SGLOBAL [ ' timestamp ' ] + $life ) : 0 , $_SC [ ' cookiepath ' ] , $_SC [ ' cookiedomain ' ] , $_SERVER [ ' SERVER_PORT ' ] == 443 ? 1 : 0 );
}