Ruby 1.8.7 リファレンスマニュアル > ライブラリ一覧 > cgiライブラリ > CGI::Cookieクラス

class CGI::Cookie

クラスの継承リスト: CGI::Cookie < Array < Enumerable < Object < Kernel

要約

クッキーを表すクラスです。

例:

cookie1 = CGI::Cookie.new("name", "value1", "value2", ...)
cookie1 = CGI::Cookie.new({"name" => "name", "value" => "value"})
cookie1 = CGI::Cookie.new({'name'    => 'name',
                           'value'   => ['value1', 'value2', ...],
                           'path'    => 'path',   # optional
                           'domain'  => 'domain', # optional
                           'expires' => Time.now, # optional
                           'secure'  => true      # optional
                          })

cgi.out({"cookie" => [cookie1, cookie2]}){ "string" }

name    = cookie1.name
values  = cookie1.value
path    = cookie1.path
domain  = cookie1.domain
expires = cookie1.expires
secure  = cookie1.secure

cookie1.name    = 'name'
cookie1.value   = ['value1', 'value2', ...]
cookie1.path    = 'path'
cookie1.domain  = 'domain'
cookie1.expires = Time.now + 30
cookie1.secure  = true

@see [RFC2965]

特異メソッド

new(name = "", *value) -> CGI::Cookie[permalink][rdoc]

クッキーオブジェクトを作成します。

第一引数にハッシュを指定する場合は、以下のキーが使用可能です。

name: クッキーの名前を指定します。必須。
value: クッキーの値、または値のリストを指定します。
path: このクッキーを適用するパスを指定します。デフォルトはこの CGI スクリプトのベースディレクトリです。
domain: このクッキーを適用するドメインを指定します。
expires: このクッキーの有効期限を Time のインスタンスで指定します。
secure: 真を指定すると、このクッキーはセキュアクッキーになります。デフォルトは偽です。セキュアクッキーは HTTPS の時のみ送信されます。

[PARAM] name:: クッキーの名前を文字列で指定します。クッキーの名前と値を要素とするハッシュを指定します。
[PARAM] value:: name が文字列である場合、値のリストを一つ以上指定します。

例：
cookie1 = CGI::Cookie.new("name", "value1", "value2", ...)
cookie1 = CGI::Cookie.new({"name" => "name", "value" => "value"})
cookie1 = CGI::Cookie.new({'name'    => 'name',
                           'value'   => ['value1', 'value2', ...],
                           'path'    => 'path',   # optional
                           'domain'  => 'domain', # optional
                           'expires' => Time.now, # optional
                           'secure'  => true      # optional
                          })

cgi.out({"cookie" => [cookie1, cookie2]}){ "string" }

name    = cookie1.name
values  = cookie1.value
path    = cookie1.path
domain  = cookie1.domain
expires = cookie1.expires
secure  = cookie1.secure

cookie1.name    = 'name'
cookie1.value   = ['value1', 'value2', ...]
cookie1.path    = 'path'
cookie1.domain  = 'domain'
cookie1.expires = Time.now + 30
cookie1.secure  = true

parse(raw_cookie) -> Hash[permalink][rdoc]

クッキー文字列をパースします。

[PARAM] raw_cookie:: 生のクッキーを表す文字列を指定します。

例：
cookies = CGI::Cookie.parse("raw_cookie_string")
  # { "name1" => cookie1, "name2" => cookie2, ... }

インスタンスメソッド

domain -> String[permalink][rdoc]

クッキーを適用するドメインを返します。

domain=(value)[permalink][rdoc]

クッキーを適用するドメインをセットします。

[PARAM] value:: ドメインを指定します。

expires -> Time[permalink][rdoc]

クッキーの有効期限を返します。

expires=(value)[permalink][rdoc]

クッキーの有効期限をセットします。

[PARAM] value:: 有効期限を Time のインスタンスで指定します。

name -> String[permalink][rdoc]

クッキーの名前を返します。

name=(value)[permalink][rdoc]

クッキーの名前をセットします。

[PARAM] value:: 名前を指定します。

path -> String[permalink][rdoc]

クッキーを適用するパスを返します。

path=(value)[permalink][rdoc]

クッキーを適用するパスをセットします。

[PARAM] value:: パスを指定します。

secure -> bool[permalink][rdoc]

自身がセキュアクッキーである場合は、真を返します。そうでない場合は、偽を返します。

secure=(val)[permalink][rdoc]

セキュアクッキーであるかどうかを変更します。

[PARAM] val:: 真を指定すると自身はセキュアクッキーになります。

to_s -> String[permalink][rdoc]

クッキーの文字列表現を返します。

value -> Array[permalink][rdoc]

クッキーの値を返します。

value=(value)[permalink][rdoc]

クッキーの値をセットします。

[PARAM] value:: 変更後の値を指定します。

class CGI::Cookie

要約

目次

特異メソッド

インスタンスメソッド