Maneig de sessions

1. Introducció
2. Identicadors de sessió
3. Maneig de sessions en PHP
4. Configuració
5. Inici i fi d’una sessió
   1. Tancar sessió
   2. Solució proposada
6. Gestió de la informació de la sessió
   1. Errors de validació
   2. Redireccions
   3. Missatges entre pàgines
7. Millores en el framework MVC

Introducció

Com acabes de veure, una forma per guardar informació particular de cada usuari és utilitzar galetes (cookies). No obstant això, hi ha diversos problemes associats a les galetes, com el nombre d’elles que admet el navegador, o la seva grandària màxima. Per solucionar aquests inconvenients, existeixen les sessions. El terme sessió fa referència al conjunt d’informació relativa a un usuari concret.

Aquesta informació pot ser tan simple com el nom de l’usuari mateix, o més complexa, com els articles que ha dipositat a la cistella de compra d’una botiga en línia.

Identicadors de sessió

Cada usuari diferent d’un lloc web té la seva pròpia informació de sessió. Per distingir una sessió d’una altra s’usen els identificadors de sessió (SID). Un SID és un atribut que s’assigna a cada un dels visitants d’un lloc web i l’identifica. D’aquesta manera, si el servidor web coneix el SID d’un usuari, pot relacionar-lo amb tota la informació que posseeix sobre ell, que es manté en la sessió de l’usuari. Aquesta informació s’emmagatzema en el servidor web, generalment en fitxers tot i que també es poden utilitzar altres mecanismes d’emmagatzematge com bases de dades. Com ja hauràs suposat, la qüestió ara és: ¿i on s’emmagatzema aquest SID, identificador de la sessió, que és únic per a cada usuari? Doncs hi ha dues maneres de mantenir el SID entre les pàgines d’un lloc web que visita l’usuari:

• Utilitzant galetes.
• Propagant el SID en un paràmetre de la URL. El SID s’afegeix com una part més de la URL, de la forma:
  • https://www.example.com/stor/list.php&PHPSESSID=34534fg4ffg34ty

En l’exemple anterior, el SID és el valor del paràmetre PHPSESSID.

Cap de les dues maneres és perfecta. Ja saps els problemes que té la utilització de cookies. Malgrat això, és el millor mètode i el més utilitzat. Propagar el SID com a part de la URL comporta majors desavantatges, com la impossibilitat de mantenir el SID entre diferents sessions, o el fet que compartir la URL amb una altra persona implica compartir també l’identificador de sessió.

Maneig de sessions en PHP

La bona notícia, és que el procés de maneig de sessions en PHP està automatitzat en gran mida. Quan un usuari visita un lloc web, no cal programar un procediment per veure si hi ha un SID previ i carregar les dades associades amb el mateix. Tampoc has d’utilitzar la funció setcookie si vols emmagatzemar els SID en galetes, o anar passant el SID entre les pàgines web del teu lloc si et decideixes per propagar. Tot això PHP ho fa automàticament.

Configuració

Per defecte, PHP inclou suport de sessions incorporat. Abans, però, d’utilitzar sessions en el teu lloc web, has de configurar correctament PHP utilitzant els següents directives en el fitxer php.ini segons corresponga:

La funció phpinfo, de la qual ja vam parlar amb anterioritat, t’ofereix informació sobre la configuració actual de les directives de sessió.

En la documentació de PHP tens informació sobre aquestes i altres directives que permeten configurar el maneig de sessions.

https://www.php.net/manual/es/session.configuration.php

Inici i fi d’una sessió

L’inici d’una sessió pot tenir lloc de dues maneres. Si has activat la directiva session.auto_start en la configuració de PHP, la sessió començarà automàticament quan un usuari es connecte al teu lloc web. En el cas que aquest usuari ja haja obert una sessió amb anterioritat, i aquesta no s’haja eliminat, en lloc d’obrir una nova sessió es reprendrà la anterior. Per a això s’utilitzarà el SID anterior, que estarà emmagatzemat en una galeta (recorda que si fas servir propagació de l’SID, no podràs restaurar sessions anteriors; el SID figura a la URL i es perd quan tanques el navegador).

Si per contra, decideixes no utilitzar l’inici automàtic de sessions, hauràs executar la funció session_start() per indicar a PHP que inicie una nova sessió o reprenga l’anterior. Anteriorment aquesta funció tornava sempre true, a partir de la versió 5.3.0 de PHP el seu comportament és més coherent: retorna false en cas de no poder iniciar o restaurar la sessió.

A més, totes les pàgines que necessiten utilitzar la informació emmagatzemada en la sessió, hauran d’executar la funció session_start.

Mentre la sessió estiga oberta, pots utilitzar la variable superglobal $_SESSION per afegir informació a la sessió de l’usuari, o per accedir a la informació emmagatzemada en la sessió. Per exemple, per comptar el nombre de vegades que l’usuari visita la pàgina, pots fer:

<?php
    // Iniciamos la sesión o recuperamos la anterior sesión existente
    session_start();
    // Comprobamos si la variable ya existe
    if (isset($_SESSION['visits']))
        $_SESSION['visits']++;
    else
        $_SESSION['visits'] = 0;
?>

Si en lloc de el nombre de visites, voldries emmagatzemar l’instant en què es produeix cadascuna, la variable de sessió “visites” ha de ser una matriu i per tant hauràs de canviar el codi anterior per:

// Iniciamos la sesión o recuperamos la anterior sesión existente
 session_start();
 // En cada visita añadimos un valor al array "visits"
 $_SESSION['visits'][] = time();

Tancar sessió

Encara que com ja has vist, pots configurar PHP perquè elimine de forma automàtica les dades de una sessió passat cert temps, en ocasions pot ser necessari tancar-la de forma manual en un moment determinat. Per exemple, si utilitzes sessions per recordar la informació d’autenticació hauràs donar-li a l’usuari de la pàgina web la possibilitat de tancar la sessió quan ho crega convenient.

En PHP tens dues funcions per eliminar la informació emmagatzemada en la sessió:

• session_unset. Elimina les variables emmagatzemades a la sessió actual, però no elimina la informació de la sessió del dispositiu d’emmagatzematge usat.
• session_destroy. Elimina completament la informació de la sessió del dispositiu de emmagatzematge.

Solució proposada

# index.php

// We turn on the session support
session_start();

$sessionKey = "visits";

// check if is the first visit
$visits = $_SESSION[$sessionKey]??[];

// if not empty generate an HTML Unordered List
if (!empty($visits))
    $messageSession =  "<ul><li>" . implode("</li><li>", array_map(function($v) {
            return date("d/m/Y h:i:s", $v);
        }, $visits)) . "</li></ul>";
else
    $messageSession = "Welcome to our reservation system (session version)!";

$_SESSION[$sessionKey][] = time();

Gestió de la informació de la sessió

Anem a utilitzar la informació de la sessió per a millorar alguns aspectes de la gestió del formulari de reserves.

Errors de validació

La pàgina de processament del formulari reservations-store.php mostra els errors de validació però no el formulari, que es troba en reservations-create.php.

El que farem serà controlar si hi ha errors en el processament i, en cas d’haver-ne, redireccionar a la pàgina reservations-create.php, emmagatzemant prèviament en la clau errors de la sessió els errors detectats.

Serà reservations-create.php qui controlarà si hi ha errors en la variable de sessió i en eixe cas els mostrarà.

// Send to the browser a new url and send a HTTP redirect code (302)
header('Location: /index.php')

// this function terminate the current script
exit();

Missatges entre pàgines

Una altra qüestió a resoldre és la de la recàrrega de pàgines que han processat un formulari. Per exemple, què passa si després d’afegir una reserva actualitzem la pàgina? Es torna a intentar crear una reserva.

Per a solucionar-ho podem combinar de nou variables de sessió i redireccions. Si la reserva s’ha realitzat correctament podem redireccionar a la pàgina index.php per exemple, i usar una variable de sessió message per a passar a index.php la confirmació de que s’ha creat correctament la reserva.

Més informació sobre les sessions en PHP: Maneig de sessions (PHP)

Millores en el framework MVC

Com ja has vist, combinant redireccions i variables de sessió podem millorar la gestió dels nostres formularis i, per extensió, la nostra aplicació web.

Es per això que en el projecte Movies implementarem la classe FlashMessage que s’encarregarà de de gestionar tant els errors de validació com els missatges entre pàgines mitjançant variables de sessió.

# src/Core/Helpers/FlashMessage.php

/**
 * Class FlashMessage
 * 
 */
class FlashMessage
{
    /**
     * string
     */
    const $sessionKey = "flash-message";

    /**
     * get the value of the key passed as argument.
     * after reading the value unsets it
     * @param string $key
     * @param string $defaultValue
     * @return mixed|string
     */
    public static function get(string $key, $defaultValue = '');

    /**
     * @param string $key
     * @param $value
     */
    public static function set(string $key, $value);

    /**
     * @param string $key
     */
    public static function unset(string $key);      
}