2D.2 クッキーの送信
| 構文 | 説明 |
|---|---|
bool setcookie ( string name [,string value [,int expire [,string path [,string domain [,int secure]]]]]) |
setcookie() は、HTTPヘッダにクッキーフィールドを定義します。 正常に実行されると TRUE を、そうでない時( 既にHTTPヘッダーを送信している場合など )は FALSE を返します。 name 以外の引数はオプションです。引数の指定をスキップする為に、空文字列( "" )を指定する事ができます。 但し、expire および secure 引数は数値なので、空文字列でスキップすることはできません。代わりにゼロ( 0 )を使用します。 各引数の仕様は以下を参照して下さい。 |
| 引数 | 説明 |
|---|---|
| name | クッキーの名前を指定します。 |
| value | クッキーの値を指定します。 |
| expire |
クッキーの有効期限。UNIX標準時(エポック(1970年1月1日)からの秒数)で指定します。 HTTPクッキー本来の expire は日付形式「 Wdy, DD-Mon-YYYY HH:MM:SS GMT 」ですが、 PHPはこの変換を内部で行います。time() 関数などにより取得した現在のUNIX標準時に、期限としたい秒数を加算したものが利用できます。 省略時は、セッションの最後( ブラウザを閉じる時 )が有効期限となります。 用例:有効期限を30日後に設定
time()+60*60*24*30 |
| path |
クッキーを有効にしたいドメイン上のパスを指定します。 '/' をセットすると、 クッキーは domain 配下の全てで有効となります。 '/foo/' をセットすると、クッキーは /foo/ ディレクトリとそのサブディレクトリ配下で有効となります。 省略時は、クッキーがセットされたときのURL中のパスになります。 |
| domain |
クッキーを有効にしたいドメインを指定します。
exapmle.com の全てのサブドメインでクッキーを有効とするには '.example.com' をセットします。
. は必須ではありませんが多くのブラウザにおいて互換性があります。 省略時は、クッキーがセットされたときのURL中のドメインになります。 |
| secure |
1 をセットするとセキュアなHTTPS接続の場合にのみクッキーが送信されるようになります。 省略時は0です。 |
