setcookie() 定义一个和其余的 HTTP 标头一起发送的 cookie。和其它标头一样,cookie 必须在脚本的任何其它输出之前发送(这是协议限制)。这需要将本函数的调用放到任何输出之前,包括 和
标签以及任何空格。如果在调用 setcookie() 之前有任何输出,本函数将失败并返回 FALSE。如果 setcookie() 函数成功运行,将返回 TRUE。这并不说明用户是否接受了 cookie。
函数定义:
bool setcookie ( string name [, string value [, int expire [, string path [, string domain [, bool secure]]]]] )
setcookie() 参数详解
参数 |
说明 |
举例 |
name |
cookie的名字 |
使用 $_COOKIE['cookiename'] 调用名为 cookiename 的 cookie。
|
value |
cookie的值,存放在客户端,不要存放敏感数据 |
假定 name 是 'cookiename',可以通过$_COOKIE['cookiename'] 取得其值。
|
expire |
Cookie 过期的时间。这是个 Unix 时间戳,即从 Unix 纪元开始的秒数。
换而言之,通常用 time() 函数再加上秒数来设定 cookie 的失效期。
或者用mktime()来实现。
|
time()+60*60*24*30 将设定 cookie 30 天后失效。
如果未设定,cookie 将会在会话结束后(一般是浏览器关闭)失效。
|
path |
Cookie 在服务器端的有效路径。 |
如果该参数设为 '/' 的话,cookie 就在整个 domain 内有效,
如果设为 '/foo/',cookie 就只在 domain 下的 /foo/ 目录及其子目录内有效,例如 /foo/bar/。
默认值为设定 cookie 的当前目录。
|
domain |
该 cookie 有效的域名。 |
要使 cookie 能在如 example.com 域名下的所有子域都有效的话,该参数应该设为 '.example.com'。
虽然 . 并不必须的,但加上它会兼容更多的浏览器。
如果该参数设为www.example.com 的话,就只在 www 子域内有效。
细节见Cookie 规范中的 tail matching。
|
secure |
指明 cookie 是否仅通过安全的 HTTPS 连接传送。
当设成 TRUE 时,cookie 仅在安全的连接中被设置。默认值为FALSE。
|
0 或 1
|
例 1. setcookie() 送信例
コードをコピー コードは次のとおりです:
$value = 'something from somewhere';
setcookie("TestCookie", $value);
setcookie ("TestCookie ", $value,time()+3600); /* 1 時間で期限切れになります */
setcookie("TestCookie", $value,time()+3600, "/~rasmus/", ".utoronto. ca", 1);
Cookie の値の部分は、送信時に urlencode で自動的にエンコードされ、受信時に自動的にデコードされ、その値が同じ名前の Cookie 変数に割り当てられることに注意してください。これを望まず、PHP 5 を使用している場合は、代わりに setrawcookie() を使用できます。 次の簡単な例では、設定したばかりの Cookie の値を取得できます:
コードをコピーします コードは次のとおりです:
// 別の Cookie を出力します
echo $_COOKIE[" TestCookie" ];
echo $HTTP_COOKIE_VARS["TestCookie"];
// 別のデバッグ方法は、すべての Cookie を出力することです
print_r($_COOKIE);
?>
Cookie を削除するには、Cookie が有効期限は以前は、ブラウザの削除メカニズムがトリガーされる可能性がありました。次の例は、設定したばかりの Cookie を削除する方法を示しています:
例 2. setcookie() 例を削除します
コードをコピーします コードは次のとおりです:
// 有効期限を 1 時間に設定しますago
setcookie( "TestCookie", "", time() - 3600);
setcookie("TestCookie", "", time() - 3600, "/~rasmus/", ".utoronto.ca", 1) ;
Cookie 名に配列記号を使用して、配列 Cookie を設定することもできます。スクリプトが Cookie を抽出すると、すべての値が配列に配置されます。
例 3. setcookie( ) arrayの使用例
コードをコピー コードは以下の通りです:
// Cookieを設定します
setcookie("cookie[three]", "cookiethree");
setcookie ("cookie[ two]", "cookietwo");
setcookie("cookie[one]", "cookieone");
// ページを更新すると表示されます
if (isset($_COOKIE['cookie '])) {
foreach ($ _Cookie ['Cookie'] as $ name = & gt; $ value) {
echo "$ name: $ value & lt; br /& gt; n"; gt; 出力:
three : cookiethree
two : cookietwo
one : cookieone
概要:
Cookie の基本的な使い方は、主にパスとドメインのパス設定をマスターすることに焦点を当てています。ドメインの名前設定。
http://www.bkjia.com/PHPjc/327934.html
www.bkjia.comtrue
http://www.bkjia.com/PHPjc/327934.html
技術記事 setcookie() は、残りの HTTP ヘッダーとともに送信される Cookie を定義します。他のヘッダーと同様に、Cookie はスクリプトからの他の出力よりも前に送信する必要があります (これはプロトコルの制限です)。 これは…