Sessions¶

Session Configuration¶

La configuration de Session est stockée dans Configure dans la clé de top niveau Session, et un certain nombre d’options sont disponibles:

• Session.cookie - Change le nom du cookie de session.

• Session.timeout - Le nombre de minutes avant que le gestionnaire de session de CakePHP ne fasse expirer la session. Cela affecte Session.autoRegenerate (ci-dessous), et cela est géré par CakeSession.

• Session.cookieTimeout - Le nombre de minutes avant que le cookie de session n’expire. S’il n’est pas défini, il utilisera la même valeur que Session.timeout. Cela affecte le cookie de session, et est geré directement par PHP.

• Session.checkAgent - Le user agent doit-il être vérifié, sur chaque requête. Si le useragent ne matche pas, la session sera détruite.

• Session.autoRegenerate - Activer cette configuration, allume automatiquement des renouvellements de sessions, et les ids de session qui changent fréquemment. Activer cette valeur va utiliser la valeur Config.countdown de la session pour garder une trace des demandes. Une fois que le compte à rebours atteint 0, l’id de session sera regénéré. C’est une bonne option à utiliser pour les applications qui necéssitent de changer fréquemment les ids de session pour des raisons de sécurité. Vous pouvez contrôler le nombre de requêtes nécessaires pour regénérer la session en modifiant CakeSession::$requestCountdown.

• Session.defaults - Vous permet d’utiliser les configurations de session intégrées par défaut comme une base pour votre configuration de session.

• Session.handler - Vous permet de définir un gestionnaire de session personnalisé. La base de données du coeur et les gestionnaires de cache de session utilisent celui-ci. Cette option remplace Session.save dans les versions précédentes. Regardez ci-dessous pour des informations supplémentaires sur les gestionnaires de Session.

• Session.ini - Vous permet de définir les configurations ini de session supplémentaire pour votre config. Ceci combiné avec Session.handler remplace les fonctionnalités de gestionnaire de session personnalisé des versions précédentes.

• Session.cacheLimiter - Vous permet de définir les en-têtes du cache control utilisées pour le cookie de session. La valeur par défaut est must-revalidate. Cette option a été ajoutée dans 2.8.0.

CakePHP met par défaut la configuration de session.cookie_secure à true, quand votre application est sur un protocole SSL. Si votre application utilise à la fois les protocoles SSL et non-SSL, alors vous aurez peut-être des problèmes de sessions perdues. Si vous avez besoin d’accéder à la session sur les deux domaines SSL et non-SSL, vous devrez désactiver cela:

Configure::write('Session', array(
    'defaults' => 'php',
    'ini' => array(
        'session.cookie_secure' => false
    )
));

Les chemins des cookies de Session sont par défaut / dans 2.0. Pour changer cela, vous pouvez utiliser le drapeau ini session.cookie_path vers le chemin du répertoire de votre application:

Configure::write('Session', array(
    'defaults' => 'php',
    'ini' => array(
        'session.cookie_path' => '/app/dir'
    )
));

Si vous utilisez les configurations par défaut de la session de php, rappelez-vous que session.gc_maxlifetime peut surcharger la configuration de votre timeout. Par défaut, il est à 24 minutes. Changez ceci dans vos configurations ini pour avoir des sessions plus longues:

Configure::write('Session', array(
    'defaults' => 'php',
    'timeout' => 2160, // 36 heures
    'ini' => array(
        'session.gc_maxlifetime' => 129600 // 36 heures
    )
));

Gestionnaires de Session intégrés & configuration¶

CakePHP dispose de plusieurs configurations de session intégrées. Vous pouvez soit utiliser celles-ci comme base pour votre configuration de session, soit créer une solution complètement personnalisée. Pour utiliser les valeurs par défaut, définissez simplement la clé “defaults” avec le nom par défaut que vous voulez utiliser. Vous pouvez ensuite surcharger toute sous-configuration en la déclarant dans votre config Session:

Configure::write('Session', array(
    'defaults' => 'php'
));

Le code précédent va utiliser la configuration de session intégrée dans “php”. Vous pourriez la modifier complètement ou en partie en faisant ce qui suit:

Configure::write('Session', array(
    'defaults' => 'php',
    'cookie' => 'my_app',
    'timeout' => 4320 //3 days
));

Le code précédent surcharge le timeout et le nom du cookie pour la configuration de session “php”. Les configurations intégrées sont:

• php - Sauvegarde les sessions avec les configurations standard dans votre fichier php.ini.

• cake - Sauvegarde les sessions en tant que fichiers à l’intérieur de app/tmp/sessions. Ceci est une bonne option lorsque les hôtes ne vous autorisent pas à écrire en dehors de votre propre dir home.

• database - Utiliser les sessions de base de données intégrées. Regardez ci-dessous pour plus d’informations.

• cache - Utiliser les sessions de cache intégrées. Regardez ci-dessous pour plus d’informations.

Configure::write('Session', array(
    'userAgent' => false,
    'cookie' => 'my_cookie',
    'timeout' => 600,
    'handler' => array(
        array('Foo', 'open'),
        array('Foo', 'close'),
        array('Foo', 'read'),
        array('Foo', 'write'),
        array('Foo', 'destroy'),
        array('Foo', 'gc'),
    ),
    'ini' => array(
        'cookie_secure' => 1,
        'use_trans_sid' => 0
    )
));

Configure::write('Session', array(
    'defaults' => 'database',
    'handler' => array(
        'model' => 'CustomSession'
    )
));

Configure::write('Session', array(
    'defaults' => 'database'
));

CREATE TABLE `cake_sessions` (
  `id` varchar(255) NOT NULL DEFAULT '',
  `data` text,
  `expires` int(11) DEFAULT NULL,
  PRIMARY KEY (`id`)
);

$ Console/cake schema create sessions

Configure::write('Session', array(
    'defaults' => 'cache',
    'handler' => array(
        'config' => 'session'
    )
));

Configurer les directives ini¶

Celui intégré par défaut tente de fournir une base commune pour la configuration de session. Vous aurez aussi besoin d’ajuster les flags ini spécifiques. CakePHP permet de personnaliser les configurations ini pour les deux configurations par défaut, ainsi que celles personnalisées. La clé ini dans les configurations de session vous permet de spécifier les valeurs de configuration individuelles. Par exemple vous pouvez l’utiliser pour contrôler les configurations comme session.gc_divisor:

Configure::write('Session', array(
    'defaults' => 'php',
    'ini' => array(
        'session.gc_divisor' => 1000,
        'session.cookie_httponly' => true
    )
));

Créer un gestionnaire de session personnalisé¶

Créer un gestionnaire de session personnalisé est simple dans CakePHP. Dans cet exemple, nous allons créer un gestionnaire de session qui stocke les sessions à la fois dans le Cache (apc) et la base de données. Cela nous donne le meilleur du IO rapide de apc, sans avoir à se soucier des sessions qui disparaissent quand le cache se remplit.

D’abord, nous aurons besoin de créer notre classe personnalisée et de la mettre dans app/Model/Datasource/Session/ComboSession.php. La classe devrait ressembler à:

App::uses('DatabaseSession', 'Model/Datasource/Session');

class ComboSession extends DatabaseSession implements CakeSessionHandlerInterface {
    public $cacheKey;

    public function __construct() {
        $this->cacheKey = Configure::read('Session.handler.cache');
        parent::__construct();
    }

    // Lit les données à partir d'une session.
    public function read($id) {
        $result = Cache::read($id, $this->cacheKey);
        if ($result) {
            return $result;
        }
        return parent::read($id);
    }

    // écrit les données dans la session.
    public function write($id, $data) {
        Cache::write($id, $data, $this->cacheKey);
        return parent::write($id, $data);
    }

    // détruit une session.
    public function destroy($id) {
        Cache::delete($id, $this->cacheKey);
        return parent::destroy($id);
    }

    // retire les sessions expirées.
    public function gc($expires = null) {
        Cache::gc($this->cacheKey);
        return parent::gc($expires);
    }
}

Notre classe étend la classe intégrée DatabaseSession donc nous ne devons pas dupliquer toute sa logique et son comportement. Nous entourons chaque opération avec une opération Cache. Cela nous permet de récupérer les sessions de la mise en cache rapide, et nous évite de nous inquiéter sur ce qui arrive quand nous remplissons le cache. Utiliser le gestionnaire de session est aussi facile. Dans votre core.php imitez le block de session ressemblant à ce qui suit:

Configure::write('Session', array(
    'defaults' => 'database',
    'handler' => array(
        'engine' => 'ComboSession',
        'model' => 'Session',
        'cache' => 'apc'
    )
));

// Assurez vous d'ajouter une config de cache apc
Cache::config('apc', array('engine' => 'Apc'));

Maintenant notre application va se lancer en utilisant notre gestionnaire de session personnalisé pour la lecture & l’écriture des données de session.

class CakeSession¶

Lire & écrire les données de session¶

Selon le contexte dans lequel vous êtes dans votre application, vous avez différentes classes qui fournissent un accès à la session. Dans les controllers, vous pouvez utiliser SessionComponent. Dans la vue, vous pouvez utiliser SessionHelper. Dans toute autre partie de votre application, vous pouvez utiliser CakeSession pour accéder aussi à la session. Comme les autres interfaces de session, CakeSession fournit une interface simple de CRUD.

static CakeSession::read($key)¶

Vous pouvez lire les valeurs de session en utilisant la syntaxe compatible Set::classicExtract():

CakeSession::read('Config.language');

static CakeSession::write($key, $value)¶

$key devrait être le chemin séparé de point et $value sa valeur:

CakeSession::write('Config.language', 'eng');

static CakeSession::delete($key)¶

Quand vous avez besoin de supprimer des données à partir de la session, vous pouvez utiliser delete:

CakeSession::delete('Config.language');

Vous devriez aussi voir la documentation sur Sessions et SessionHelper sur la façon d’accéder aux données de Session dans le controller et la vue.