Module: ActionController::Cookies

Defined in:
lib/action_controller/cookies.rb

Overview

Cookies are read and written through ActionController#cookies. The cookies being read is what was received along with the request, the cookies being written is what will be sent out will the response. Cookies are read by value (so you won't get the cookie object itself back – just the value it holds). Examples for writing:

cookies[:user_name] = "david" # => Will set a simple session cookie
cookies[:login] = { :value => "XJ-122", :expires => Time.now + 360} # => Will set a cookie that expires in 1 hour

Examples for reading:

cookies[:user_name] # => "david"
cookies.size         # => 2

Example for deleting:

cookies.delete :user_name

All the option symbols for setting cookies are:

  • value - the cookie's value or list of values (as an array).

  • path - the path for which this cookie applies. Defaults to the root of the application.

  • domain - the domain for which this cookie applies.

  • expires - the time at which this cookie expires, as a Time object.

  • secure - whether this cookie is a secure cookie or not (default to false). Secure cookies are only transmitted to HTTPS servers.