tutoriais mais recente desenvolvimento web
 

PHP setrawcookie() Function

<PHP Referência HTTP

Exemplo

O exemplo a seguir cria um cookie com PHP. O cookie é chamado "user" e o valor será "John Doe" . O valor do cookie não será URL codificada. O cookie expira após 30 dias (86400 * 30) . Usando "/" , significa que o cookie está disponível em todo o site (otherwise, select the directory you prefer) :

<?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>
?>
Exemplo executar »

Definição e Uso

O setrawcookie() função define um cookie (without URL encoding) para 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 setrawcookie() função deve aparecer antes do <html> tag.

Note: Para automaticamente URL-codificar o valor do cookie ao enviar e, automaticamente decodificar ao receber, utilize o setcookie() função em vez.

Sintaxe

setrawcookie( name,value,expire,path,domain,secure );

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 não for definido, o cookie irá expirar no final da sessão (when the browser closes)
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.

Detalhes técnicos

Valor de retorno: TRUE em caso de sucesso. Em caso de falha
PHP Versão: 5+

mais Exemplos

Exemplo

Recuperar o valor do cookie chamado "user" (usando a variável $ _COOKIE global). Também utilize o isset() função para descobrir se o cookie existe:

<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>
Exemplo executar »

Exemplo

Para modificar um cookie, basta definir (again) o cookie usando o setrawcookie() função:

<?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>
Exemplo executar »

Exemplo

Para excluir um cookie, use o setrawcookie() função com uma data de expiração no passado:

<?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>
Exemplo executar »

Exemplo

Criar um pequeno script que verifica se cookies estão habilitados. Primeiro, tente criar um cookie de teste com o setrawcookie() função, em seguida, contar a variável array $ _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>
Exemplo executar »

<PHP Referência HTTP