Exemplo
O exemplo a seguir cria um cookie chamado "user" com o valor "John Doe" . O cookie expira após 30 dias (86400 * 30) . O "/" significa que o cookie está disponível em todo o site (otherwise, select the directory you prefer) .
Em seguida, recuperar o valor do cookie "user" (usando a variável $ _COOKIE global). Nós também usamos o isset() função para descobrir se o cookie é definido:
<!DOCTYPE html>
<?php
$cookie_name = "user";
$cookie_value = "John
Doe";
setcookie($cookie_name, $cookie_value, time() + (86400 * 30), "/");
// 86400 = 1 day
?>
<html>
<body>
<?php
if(!isset($_COOKIE[$cookie_name]))
{
echo "Cookie named '" . $cookie_name . "' is not
set!";
} else {
echo "Cookie '" . $cookie_name
. "' is set!<br>";
echo "Value is: " . $_COOKIE[$cookie_name];
}
?>
</body>
</html>
Exemplo executar » Definição e Uso
O setcookie() função define um biscoito a ser enviado, juntamente com o resto dos cabeçalhos HTTP.
Um cookie é muitas vezes usado para identificar um usuário. Um cookie é um pequeno arquivo que o servidor incorpora no computador do usuário. Cada vez que o mesmo computador solicita uma página com um navegador, ele irá enviar o cookie também. Com PHP, você pode tanto criar e recuperar valores de cookies.
O nome do cookie é automaticamente atribuído a uma variável com o mesmo nome. Por exemplo, se um cookie foi enviado com o nome de "user" , uma variável é criado automaticamente chamado $ usuário, contendo o valor do cookie.
Note: O setcookie() função deve aparecer antes do <html> tag.
Note: O valor do cookie é urlencoded automaticamente ao enviar o cookie, e decodificados automaticamente quando recebeu (para evitar URLEncoding, uso setrawcookie() em vez disso).
Sintaxe
setcookie( name,value,expire,path,domain,secure,httponly );
Parâmetro | Descrição |
---|---|
name | Requeridos. Especifica o nome do cookie |
value | Opcional. Especifica o valor do cookie |
expire | Opcional. Especifica quando o cookie expira. O valor: time() + 86400 * 30, irá definir o cookie para expirar em 30 dias. Se este parâmetro for omitido ou definido como 0, o cookie irá expirar no final da sessão (when the browser closes) . O padrão é 0 |
path | Opcional. Especifica o caminho do servidor do cookie. Se definido como "/" , o cookie estará disponível dentro de todo o domínio. Se definido como "/php/" , o cookie só estarão disponíveis dentro do diretório php e todos os sub-diretórios de php. O valor padrão é o diretório atual que o cookie está sendo definido em |
domain | Opcional. Especifica o nome do domínio do cookie. Para fazer com que o cookie disponível em todos os subdomínios de example.com, definir domínio para "example.com" . Defini-lo para www.example.com fará o cookie disponível apenas no subdomínio www |
secure | Opcional. Especifica se o cookie só devem ser transmitidos através de uma conexão segura HTTPS. TRUE indica que o cookie só será definido se existe uma conexão segura. O padrão é FALSE |
httponly | Opcional. Se definido como verdadeiro o cookie será acessível apenas através do protocolo HTTP (the cookie will not be accessible by scripting languages) . Esta configuração pode ajudar a reduzir o roubo de identidade por meio de ataques XSS. O padrão é FALSE |
Detalhes técnicos
Valor de retorno: | TRUE em caso de sucesso. Em caso de falha |
---|---|
PHP Versão: | 4+ |
PHP Changelog: | PHP 5.5 - Um atributo Max-Age foi incluído no cabeçalho Set-Cookie enviado para o cliente PHP 5.2 - foi adicionado O parâmetro httponly |
mais Exemplos
Exemplo
Vários expirar datas para cookies:
<?php
$value = "Hello world!";
// cookie will expire when the
browser close
setcookie("myCookie", $value);
// cookie will expire
in 1 hour
setcookie("myCookie", $value, time() + 3600);
// cookie
will expire in 1 hour, and will only be available
// within the php
directory + all sub-directories of php
setcookie("myCookie", $value,
time() + 3600, "/php/");
?>
<html>
<body>
...some code...
</body>
</html>
Exemplo executar » Exemplo
Para modificar um cookie, basta definir (again) o cookie usando o setcookie() função:
<?php
$cookie_name = "user";
$cookie_value = "Alex
Porter";
setcookie($cookie_name, $cookie_value, time() + (86400 * 30), "/");
?>
<html>
<body>
<?php
if(!isset($_COOKIE[$cookie_name]))
{
echo "Cookie named '" . $cookie_name . "' is not
set!";
} else {
echo "Cookie '" . $cookie_name
. "' is set!<br>";
echo "Value is: " . $_COOKIE[$cookie_name];
}
?>
</body>
</html>
Exemplo executar » Exemplo
Para excluir um cookie, use o setcookie() função com uma data de expiração no passado:
<?php
// set the expiration date to one hour ago
setcookie("user",
"" , time() - 3600);
?>
<html>
<body>
<?php
echo "Cookie 'user'
is deleted.";
?>
</body>
</html>
Exemplo executar » Exemplo
Criar um pequeno script que verifica se cookies estão habilitados. Primeiro, tente criar um cookie de teste com a setcookie() função, em seguida, contar a variável array $ _COOKIE:
<?php
setcookie("test_cookie", "test" , time() + 3600, '/');
?>
<html>
<body>
<?php
if(count($_COOKIE) > 0) {
echo "Cookies are enabled.";
} else {
echo "Cookies
are disabled.";
}
?>
</body>
</html>
Exemplo executar » <PHP Referência HTTP