Asistente de Cookie
El archivo Asistente de Cookie contiene funciones que asisten al trabajo con cookies.
Cargando este Asistente
Este asistente es cargado usando el siguiente código:
$this->load->helper('cookie');
Las siguientes funciones están disponibles:
set_cookie()
Establece una cookie conteniendo el valor especificado. Hay dos formas de pasar información a esta función para que la cookie pueda ser establecida: Método de Arreglo, y Parámetros Discretos:
Método de Arreglo
Usando este método, un arreglo asociativo es pasado al primer parámetro:
$cookie = array(
'name' => 'El nombre de la Cookie',
'value' => 'El Valor',
'expire' => '86500',
'domain' => '.un-dominio.com',
'path' => '/',
'prefix' => 'miprefijo_',
);
set_cookie($cookie);
Notas:
Sólo el nombre y valor son requieridos.
La expiración es establecida en segundos, que serán agregados al horario actual. No incluya el horario, sino sólo el número de segundos desde ahora que desea que la cookie sea valida. Si la expiración es establecida como cero, la cookie sólo durará tanto como el explorador esté abierto.
Para borrar una cookie establezcala con expiración vacía.
Para cookies a lo ancho del sitio independientemente de como el sitio es requerido, agregue su URL al dominop empezando con punto, como esto: .tu-dominio.com
La ruta es usualmente no necesaria ya que la función establece una ruta a la raíz.
El prefijo es sólo necesario para evitar colisioens de nombre con otros nombres de cookies idénticos para su servidor.
Parámetros Discretos
Si prefieres, puede establecer una cookie pasando datos usando parámetros individuales:
set_cookie($nombre, $valor, $expiracion, $dominio, $ruta, $prefijo);
get_cookie()
Le permite traer una cookie. El primer parámetro contendrá el nombre de la cookie que está buscando:
get_cookie('alguna_cookie');
Esta función devuelve FALSE (booleano) si el item que está intentando recuperar no existe.
El segundo parámetro opcional le permite correr los datos a través de un filtro XSS. Está hablitado al establecer el segundo parámetro como el booleano TRUE;
get_cookie('alguna_cookie', TRUE);
delete_cookie()
Le permite eliminar una cookie. A menos que haya establecido una ruta especial u otros valores, sólo el nombre de la cookie es requerido:
delete_cookie("name");
Esta función es de otra forma idéntica a set_cookie(), excepto que no tiene los parámetros del valor y la expiración. Puede enviar un arreglo de valores en el primer parámetro o establecerlos de forma discreta.
delete_cookie($nombre, $dominio, $ruta, $prefijo)