Class representing an HTTP cookie.
In addition to its specific fields and methods, a Cookie instance is a delegator to the array of its values.
See RFC 2965.
Examples of use
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
'httponly' => 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
httponly = cookie1.httponly
cookie1.name = 'name'
cookie1.value = ['value1', 'value2', ...]
cookie1.path = 'path'
cookie1.domain = 'domain'
cookie1.expires = Time.now + 30
cookie1.secure = true
cookie1.httponly = true
Name of this cookie, as a String
Path for which this cookie applies, as a String
Domain for which this cookie applies, as a String
True if this cookie is secure; false otherwise
True if this cookie is httponly; false otherwise
# File tmp/rubies/ruby-2.7.6/lib/cgi/cookie.rb, line 71
def initialize(name = "", *value)
@domain = nil
@expires = nil
if name.kind_of?(String)
@name = name
@path = (%r|\A(.*/)| =~ ENV["SCRIPT_NAME"] ? $1 : "")
@secure = false
@httponly = 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
@path = options["path"] || (%r|\A(.*/)| =~ ENV["SCRIPT_NAME"] ? $1 : "")
@domain = options["domain"]
@expires = options["expires"]
@secure = options["secure"] == true
@httponly = options["httponly"] == true
super(value)
end
Create a new CGI::Cookie object.
name_string-
The name of the cookie; in this form, there is no
domainor expiration. Thepathis gleaned from theSCRIPT_NAMEenvironment variable, andsecureis false. *value-
value or list of values of the cookie
options_hash-
A
Hashof options to initialize thisCookie. Possible options are:- name
-
the name of the cookie. Required.
- value
-
the cookie’s value or list of values.
- path
-
the path for which this cookie applies. Defaults to the value of the
SCRIPT_NAMEenvironment variable. - domain
-
the domain for which this cookie applies.
- expires
-
the time at which this cookie expires, as a
Timeobject. - secure
-
whether this cookie is a secure cookie or not (default to false). Secure cookies are only transmitted to HTTPS servers.
- httponly
-
whether this cookie is a HttpOnly cookie or not (default to
false). HttpOnly cookies are not available to javascript.
These keywords correspond to attributes of the cookie object.
# File tmp/rubies/ruby-2.7.6/lib/cgi/cookie.rb, line 155
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
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
Parse a raw cookie string into a hash of cookie-name=>Cookie pairs.
cookies = CGI::Cookie.parse("raw_cookie_string") # { "name1" => cookie1, "name2" => cookie2, ... }
# File tmp/rubies/ruby-2.7.6/lib/cgi/cookie.rb, line 133
def httponly=(val)
@httponly = !!val
end
# File tmp/rubies/ruby-2.7.6/lib/cgi/cookie.rb, line 174
def inspect
"#<CGI::Cookie: #{self.to_s.inspect}>"
end
A summary of cookie string.
# File tmp/rubies/ruby-2.7.6/lib/cgi/cookie.rb, line 125
def secure=(val)
@secure = val if val == true or val == false
@secure
end
# File tmp/rubies/ruby-2.7.6/lib/cgi/cookie.rb, line 138
def to_s
val = collect{|v| CGI.escape(v) }.join("&")
buf = "#{@name}=#{val}".dup
buf << "; domain=#{@domain}" if @domain
buf << "; path=#{@path}" if @path
buf << "; expires=#{CGI.rfc1123_date(@expires)}" if @expires
buf << "; secure" if @secure
buf << "; HttpOnly" if @httponly
buf
end
Convert the Cookie to its string representation.
# File tmp/rubies/ruby-2.7.6/lib/cgi/cookie.rb, line 113
def value
self
end
Returns the value or list of values for this cookie.
# File tmp/rubies/ruby-2.7.6/lib/cgi/cookie.rb, line 118
def value=(val)
replace(Array(val))
end
Replaces the value of this cookie with a new value or list of values.