CGI::Cookie — Ruby 2.2

Родитель:: Массив

Класс, представляющий HTTP-cookie.

Помимо собственных полей и методов, экземпляр Cookie является делегатом к массиву своих значений.

См. RFC 2965.

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

Атрибуты

domain[RW]

Домен, к которому относится данный cookie, в виде String

expires[RW]

Время истечения действия этого cookie, в виде Time

name[RW]

Имя этого cookie, в виде String

path[RW]

Путь, к которому относится данный cookie, в виде String

secure[R]

Истина, если этот cookie защищён; ложь в противном случае

Публичные методы класса

new(name_string,*value) Показать исходный код

new(options_hash)

# File lib/cgi/cookie.rb, line 65
def initialize(name = "", *value)
  @domain = nil
  @expires = nil
  if name.kind_of?(String)
    @name = name
    %r|^(.*/)|.match(ENV["SCRIPT_NAME"])
    @path = ($1 or "")
    @secure = false
    return super(value)
  end

  options = name
  unless options.has_key?("name")
    raise ArgumentError, "`name' required"
  end

  @name = options["name"]
  value = Array(options["value"])
  # simple support for IE
  if options["path"]
    @path = options["path"]
  else
    %r|^(.*/)|.match(ENV["SCRIPT_NAME"])
    @path = ($1 or "")
  end
  @domain = options["domain"]
  @expires = options["expires"]
  @secure = options["secure"] == true ? true : false

  super(value)
end

Создаёт новый объект CGI::Cookie.

name_string

Имя cookie; в этом формате нет домена или срока действия. Путь path извлекается из переменной среды SCRIPT_NAME, а secure имеет значение ложь.

*value

Значение или список значений cookie

options_hash

Словарь опций для инициализации этого Cookie. Возможные опции:

name: имя cookie. Требуется.
value: значение или список значений cookie.
path: путь, к которому относится этот cookie. По умолчанию совпадает со значением переменной среды SCRIPT_NAME
domain: домен, к которому относится этот cookie.
expires: время истечения срока действия этого cookie, в виде объекта Time
secure: является ли этот cookie защищённым (по умолчанию ложь). Защищённые cookie передаются только серверам HTTPS.

Эти ключевые слова соответствуют атрибутам объекта cookie.

Вызывает метод суперкласса Array.new

parse(raw_cookie) Показать исходный код

# File lib/cgi/cookie.rb, line 143
def self.parse(raw_cookie)
  cookies = Hash.new([])
  return cookies unless raw_cookie

  raw_cookie.split(/[;,]\s?/).each do |pairs|
    name, values = pairs.split('=',2)
    next unless name and values
    name = CGI.unescape(name)
    values ||= ""
    values = values.split('&').collect{|v| CGI.unescape(v,@@accept_charset) }
    if cookies.has_key?(name)
      values = cookies[name].value + values
    end
    cookies[name] = Cookie.new(name, *values)
  end

  cookies
end

Разбирает строку raw cookie в словарь пар cookie-имя=>Cookie.

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

Публичные методы экземпляра

inspect() Показать исходный код

# File lib/cgi/cookie.rb, line 163
def inspect
  "#<CGI::Cookie: #{self.to_s.inspect}>"
end

Краткое описание cookie-строки.

secure=(val) Показать исходный код

# File lib/cgi/cookie.rb, line 121
def secure=(val)
  @secure = val if val == true or val == false
  @secure
end

Устанавливает, является ли Cookie защищённым cookie.

val должно быть булевым значением.

to_s() Показать исходный код

# File lib/cgi/cookie.rb, line 127
def to_s
  val = collect{|v| CGI.escape(v) }.join("&")
  buf = "#{@name}=#{val}"
  buf << "; domain=#{@domain}" if @domain
  buf << "; path=#{@path}"     if @path
  buf << "; expires=#{CGI::rfc1123_date(@expires)}" if @expires
  buf << "; secure"            if @secure == true
  buf
end

Преобразует Cookie в его строковое представление.

value() Показать исходный код

# File lib/cgi/cookie.rb, line 109
def value
  self
end

Возвращает значение или список значений для данного cookie.

value=(val) Показать исходный код

# File lib/cgi/cookie.rb, line 114
def value=(val)
  replace(Array(val))
end

Заменяет значение данного cookie новым значением или списком значений.

Ruby Core © 1993–2017 Yukihiro Matsumoto
Licensed under the Ruby License.
Ruby Standard Library © contributors
Licensed under their own licenses.

класс CGI::Cookie

Примеры использования