Assistente de Cookie

O arquivo Assistente de Cookie contem funções que auxiliam no trabalho com cookies.

Carregando este Assistente

Este assistente é carregado usando o seguinte código:

$this->load->helper('cookie');

As seguinte funções estão disponíveis:

set_cookie()

Configura um cookie contendo os valores que você especificar. Existe dois modos de passar a informação a esta função de modo que o cookie pode ser configurado como: Método de Array, e Parâmetros Discretos(Discreet Parameters):

Método de Array

Usando este método, um array associativo é passado ao primeiro parâmetro:

$cookie = array(

                   'name'   => 'O Nome do Cookie',

                   'value'  => 'O Valor',

                   'expire' => '86500',

                   'domain' => '.algum-dominio.com',

                   'path'   => '/',

                   'prefix' => 'meuprefixo_',

               );



set_cookie($cookie);

Notas:

Apenas o nome(name) e valor(value) são obrigatórios.

O tempo de expiração(expire) do cookie é ajustado em segundos, que será adicionado à hora atual.Não inclua a hora, apenas os segundos a partir do momento que você deseja que o cookie seja válido . Se o tempo de expiração estiver configurado como zero o cookie durará apenas o tempo em que o browser estiver aberto.

Para apagar um cookie configure o tempo de expiração em branco/sem valor.

Para cookies que abranjam todo site não importando como este seja requisitado, adicione sua URL ao domain começando com um perído, como este: .seu-dominio.com

O caminho (path) é normalmente desnecessário desde que a função configure um caminho raiz.

O prefixo é apenas necessário se você precisar evitar colisões de nomes dos cookies no seu servidor.

Parâmetros Discretos(Discreet Parameters)

Se você preferir, pode configurar o cookie passando os dados usando parâmetros individuais:

set_cookie($name, $value, $expire, $domain, $path, $prefix);

get_cookie()

Permite que você busque um cookie. O primeiro parâmetro conterá o nome do cookie que vocês está buscando:

get_cookie('algum_cookie');

A função retornará FALSE (booleano) se o item que você estiver tentando recuperar não existir.

O segundo parâmetro opcional permite você executar os dados através do filtro XSS. Este estará habilitado ao configurar o segundo parâmetro para TRUE;

get_cookie('algum_cookie', TRUE);

delete_cookie()

Permite que você apague um cookie. A não ser que você tenha configurado um caminho personalizado ou outros valores, apenas o nome do cookie é necessário:

delete_cookie("nome");

Esta função, por sua vez, é idêntica à set_cookie(), exceto pelo fato de não ter os parâmetros de valor (value) e expiração(expire). Você pode submeter um array de valores no primeiro parâmetro ou pode configurar parâmetros discretos(discreet parameters).

delete_cookie($name, $domain, $path, $prefix)