setcookie

setcookie -- クッキーを送信する

説明

int setcookie(string name, string value, int expire, string path, string domain, int secure);

SetCookie() は、その他のヘッダ情報に従って 送られるべきクッキーを定義します。name を除くすべての引数はオプションです。name 引数しか指定されない 場合は、その名前を持つクッキーがリモート・クライアントから削除 されます。また特定の引数をスキップするために、どの引数にも 空文字列("")を指定することが できます。ただし expire secure 引数は整数であり、空文字列でスキップすること はできないので、代わりにゼロ (0) を使って 下さい。expire 引数は、通常の Unix Time 整数で、time() または mktime() 関数により返されるものです。secure は、 クッキーが安全な HTTPS コネクションを通して転送されるべきことを 指示します。以下にいくつか例を示します。

Example 1. SetCookie の例

SetCookie("TestCookie","Test Value");
SetCookie("TestCookie",$value,time()+3600);  /* 1時間で無効にする */
SetCookie("TestCookie",$value,time()+3600,"/~rasmus/",".utoronto.ca",1);

クッキーの value 部分は、クッキーの送信を行う際に自動的に URL エンコードされ、またクッキーを受信した際は、自動的にデコード されてクッキー名と同じ名前の変数に格納されます。すなわち、 スクリプト内部でテスト・クッキーの内容を見たい場合は、単に

echo $TestCookie;

とすればよいということです。

クッキーに関する詳細は、http://www.netscape.com/newsref/std/cookie_spec.html にある Netscape のクッキー仕様をご覧ください。