Funkce PHP setrawcookie().
Příklad
Následující příklad vytvoří soubor cookie s PHP. Soubor cookie se jmenuje „user“ a hodnota bude „John Doe“. Hodnota souboru cookie nebude zakódována do adresy URL. Platnost cookie vyprší po 30 dnech (86400 * 30). Použití „/“ znamená, že soubor cookie je dostupný na celém webu (v opačném případě vyberte adresář, který preferujete):
<?php
$cookie_name = "user";
$cookie_value = "John";
setrawcookie($cookie_name, $cookie_value, time() + (86400 * 30), "/");
// 86400 = 1 day
?>
<html>
<body>
<?php
echo "Cookie is set.";
?>
</body>
</html>
?>
Definice a použití
Funkce setrawcookie() definuje cookie (bez kódování URL), která má být odeslána spolu se zbytkem HTTP hlaviček.
K identifikaci uživatele se často používá cookie. Cookie je malý soubor, který server vloží do počítače uživatele. Pokaždé, když stejný počítač požádá o stránku s prohlížečem, odešle také cookie. Pomocí PHP můžete vytvářet i získávat hodnoty souborů cookie.
Název souboru cookie je automaticky přiřazen ke stejnojmenné proměnné. Pokud byl například soubor cookie odeslán se jménem „user“, automaticky se vytvoří proměnná s názvem $user obsahující hodnotu cookie.
Poznámka: Funkce setrawcookie() se musí objevit PŘED tagem <html>.
Poznámka: Chcete-li automaticky zakódovat URL hodnotu cookie při odesílání a automaticky dekódovat při příjmu, použijte místo toho funkci setcookie() .
Syntax
setrawcookie(name, value, expire, path, domain, secure);
Hodnoty parametrů
| Parameter | Description |
|---|---|
| name | Required. Specifies the name of the cookie |
| value | Optional. Specifies the value of the cookie |
| expire | Optional. Specifies when the cookie expires. The value: time()+86400*30, will set the cookie to expire in 30 days. If this parameter is not set, the cookie will expire at the end of the session (when the browser closes) |
| path | Optional. Specifies the server path of the cookie. If set to "/", the cookie will be available within the entire domain. If set to "/php/", the cookie will only be available within the php directory and all sub-directories of php. The default value is the current directory that the cookie is being set in |
| domain | Optional. Specifies the domain name of the cookie. To make the cookie available on all subdomains of example.com, set domain to ".example.com". Setting it to www.example.com will make the cookie only available in the www subdomain |
| secure | Optional. Specifies whether or not the cookie should only be transmitted over a secure HTTPS connection. TRUE indicates that the cookie will only be set if a secure connection exists. Default is FALSE. |
Technické údaje
| Návratová hodnota: | PRAVDA o úspěchu. NEPRAVDA při selhání |
|---|---|
| Verze PHP: | 5+ |
Další příklady
Příklad
Získejte hodnotu souboru cookie s názvem „user“ (pomocí globální proměnné $_COOKIE). Pomocí funkce isset() také zjistěte, zda soubor cookie existuje:
<html>
<body>
<?php
$cookie_name = "user";
if(!isset($_COOKIE[$cookie_name])) {
echo "Cookie named '" . $cookie_name . "' does not exist!";
} else {
echo "Cookie is named: " . $cookie_name . "<br>Value is: " . $_COOKIE[$cookie_name];
}
?>
</body>
</html>
Příklad
Chcete-li upravit cookie, stačí nastavit (znovu) cookie pomocí funkce setrawcookie():
<?php
$cookie_name = "user";
$cookie_value = "Alex";
setrawcookie($cookie_name, $cookie_value, time() + (86400 * 30), "/");
?>
<html>
<body>
<?php
$cookie_name = "user";
if(!isset($_COOKIE[$cookie_name])) {
echo "Cookie named '" . $cookie_name . "' does not exist!";
} else {
echo "Cookie is named: " . $cookie_name . "<br>Value is: " . $_COOKIE[$cookie_name];
}
?>
</body>
</html>
Příklad
Chcete-li soubor cookie odstranit, použijte funkci setrawcookie() s datem vypršení platnosti v minulosti:
<?php
$cookie_name = "user";
unset($_COOKIE[$cookie_name]);
// empty value and expiration one hour before
$res = setrawcookie($cookie_name, '', time() - 3600);
?>
<html>
<body>
<?php
echo "Cookie 'user' is deleted.";
?>
</body>
</html>
Příklad
Vytvořte malý skript, který kontroluje, zda jsou povoleny soubory cookie. Nejprve zkuste vytvořit testovací cookie pomocí funkce setrawcookie() a poté spočítejte proměnnou pole $_COOKIE:
<?php
setrawcookie("test_cookie", "test", time() + 3600, '/');
?>
<html>
<body>
<?php
if(count($_COOKIE) > 0) {
echo "Cookies are enabled";
} else {
echo "Cookies are disabled";
}
?>
</body>
</html>
❮ Síťová reference PHP