setcookie

PHP -> Funkcie -> HTTP funkcie PHP -> setcookie

Syntax

bool setcookie ( string $name [, string $value [, int $expire [, string $path [, string $domain [, bool $secure [, bool $httponly] ] ] ] ] ] )


Popis

Funkcia PHP.
Send a cookie

setcookie definuje cookie, ktoré majú byť zaslané spolu so zvyškom HTTP hlavičky. Rovnako ako ostatné hlavičky, cookies, musí byť odoslaná pred výstupom z vášho skriptu (to je obmedzenie protokolu HTTP). To si vyžaduje, aby ste túto funkciu mali umiestnenú pred akýmkoľvek textom, vrátane tagov <html>, <head> a akejkoľvek medzery.

All the arguments except the name argument are optional. If only the name argument is present, the cookie by that name will be deleted from the remote client. You may also replace any argument with an empty string ("") in order to skip that argument. The expire and secure arguments are integers and cannot be skipped with an empty string. Use a zero (0) instead. The expire argument is a regular Unix time integer as returned by the time or mktime functions. The secure indicates that the cookie should only be transmitted over a secure HTTPS connection.

Common Pitfalls:
Cookies will not become visible until the next loading of a page that the cookie should be visable for.
Multiple calls to setcookie in the same script will be performed in the reverse order. If you are trying to delete one cookie before inserting another you should put the insert before the delete.

Note that the value portion of the cookie will aically be urlencoded when you send the cookie, and when it is received, it is aically decoded and assigned to a variable by the same name as the cookie name.

Parameter
Description
Examples
name
The name of the cookie.
'cookiename' is called as $_COOKIE['cookiename']
value
The value of the cookie. This value is stored on the clients computer; do not store sensitive information.
Assuming the name is 'cookiename', this value is retrieved through $_COOKIE['cookiename']
expire
The time the cookie expires. This is a Unix timestamp so is in number of seconds since the epoch. In other words, you'll most likely set this with the time function plus the number of seconds before you want it to expire. Or you might use mktime.
time()+60*60*24*30 will set the cookie to expire in 30 days. If set to 0, or omitted, the cookie will expire at the end of the session (when the browser closes).
path
The path on the server in which the cookie will be available on.
If set to '/', the cookie will be available within the entire domain. If set to '/foo/', the cookie will only be available within the /foo/ directory and all sub-directories such as /foo/bar/ of domain. The default value is the current directory that the cookie is being set in.
domain
The domain that the cookie is available.
To make the cookie available on all subdomains of example.com then you'd set it to '.example.com'. The . is not required but makes it compatible with more browsers. Setting it to www.example.com will make the cookie only available in the www subdomain. Refer to tail matching in the » spec for details.
secure
Indicates that the cookie should only be transmitted over a secure HTTPS connection from the client. When set to TRUE, the cookie will only be set if a secure connection exists. The default is FALSE. On the server-side, it's on the programmer to send this kind of cookie only on secure connection (e.g. with respect to $_SERVER["HTTPS"]).
TRUE or FALSE
httponly
When TRUE the cookie will be made accessible only through the HTTP protocol. This means that the cookie won't be accessible by scripting languages, such as JavaScript. This setting can effectly help to reduce identity theft through XSS attacks (although it is not supported by all browsers). Added in PHP 5.2.0.
TRUE or FALSE



Príklad

setcookie("TestCookie","Test Value");
setcookie("TestCookie", $value, time()+3600); /* expire in 1 hour */
setcookie("TestCookie", $value, time()+3600,"/~rasmus/",".utoronto.ca",1);

// after reload
echo $TestCookie;
echo $HTTP_COOKIE_VARS["TestCookie"];