setcookie

(PHP3 , PHP4)

setcookie --- 送出cookie

语法 : int setcookie (string name [, string value [, int expire [, string path [, string domain [, int secure]]]]])

说明 :

setcookie( )定义一个cookie和标头一起送出。cookie必须在任何其它的标头送出之前送出，这是cookie的限制，而不是PHP。你必须在任何<html>或是<head>标签之前呼叫此函数。

除了参数name之外，其它都是非必需的。如果只有name这一个参数，则用户端(client)此名称的cookie将会被删除，你也可以使用空字符串(" ")来略过此参数，参数expire和secure是个整数，你可以使用0来略过参数，而不是使用空字符串。参数expire是一个正规的Unix时间整数，由time( )和mktime( )传回。参数secure指出此cookie将只有在安全的HTTPS连结时传送。

常见的错误 :

cookies将不变成可看见的，直到下次页面载入时，此cookies才将成为可看见的。 cookies必须以它们所设定的相同参数值，才能将它删除。在PHP3中，在相同的程式里多次的呼叫setcookie( )，将会以颠倒的顺序来执行。如果你想在插入另一个值之前删除cookie，你应该先执行插入之后再执行删除。在PHP4中，多次的呼叫setcookie( )会依照呼叫的顺序来执行。

下面的范例说明如何去送出cookies :

Example :

<?php

setcookie ("TestCookie", "Test Value");

setcookie ("TestCookie", $value,time()+3600); /* expire in 1 hour */

setcookie ("TestCookie", $value,time()+3600, "/~rasmus/", ".utoronto.ca", 1);

下面的范例说明如何将上面范例所送出的cookies删除 :

<?php

setcookie ("TestCookie");

setcookie ("TestCookie", "", time());

setcookie ("TestCookie", "", time(), "/~rasmus/", ".utoronto.ca", 1);

当你送出cookie时，cookie一部份的值将会自动地urlencoded，并且当接收到此cookie时，它会自动地decoded并分配它，使它成为变量，变量的名称则与cookie的名称相同。我们可以简单的使用下列范例的其中一个方法，来看见cookie的内容 :

<?php

echo $TestCookie;

echo $HTTP_COOKIE_VARS["TestCookie"];

你也可以在cookie的名称中使用数组的标记法，来设定数组cookies，这种设定的结果就像是你有着许多的cookie，但是当你的程式接收到cookie时，cookie的值全部都会放在数组之中 :

<?php

setcookie ("cookie[three]", "cookiethree");

setcookie ("cookie[two]", "cookietwo");

setcookie ("cookie[one]", "cookieone");

if (isset ($cookie)) {

while (list ($name, $value) = each ($cookie)) {

echo "$name == $value<br>

}