$cjar
->set_cookie (version
,key
,val
,path
,domain
,port
,path_spec
,secure
,maxages
,discard
, \%misc
)
Sets a cookie in the cookie jar with the information given in the arguments. The number and order of arguments represent the structure of elements in the Set-Cookie3 header lines used to save the cookies in a file.
A string containing the cookie-spec version number.
The name of the cookie.
The value of the cookie.
The pathname of the URL for which the cookie is set.
The domain name for which the cookie is set.
The port number of the URL for which the cookie is set.
A Boolean value indicating if the cookie is valid for the specific URL path or all the URLs in the domain. The path is used if true; otherwise, the cookie is valid for the entire domain.
A Boolean value indicating that the cookie should only be sent over a secure connection for true, or over any connection, if false.
The number of seconds that the cookie will be valid, from the time it was received. Adding the maxage to the current time will yield a value that can be used for an expiration date.
A Boolean value indicating that the cookie should not be sent in any future requests and should be discarded upon saving the cookie jar, unless the
ignore_discard
parameter was set to true in the constructor.
The final argument is a reference to a hash, %misc , that contains any additional parameters from the Set-Cookie headers such as Comment and URLComment, in key/value pairs.