CacheSession.php 2.94 KB
Newer Older
Qiang Xue committed
1 2 3
<?php
/**
 * @link http://www.yiiframework.com/
Qiang Xue committed
4
 * @copyright Copyright (c) 2008 Yii Software LLC
Qiang Xue committed
5 6 7 8 9
 * @license http://www.yiiframework.com/license/
 */

namespace yii\web;

Qiang Xue committed
10 11 12 13
use Yii;
use yii\caching\Cache;
use yii\base\InvalidConfigException;

Qiang Xue committed
14 15 16
/**
 * CacheSession implements a session component using cache as storage medium.
 *
Qiang Xue committed
17
 * The cache being used can be any cache application component.
18
 * The ID of the cache application component is specified via [[cache]], which defaults to 'cache'.
Qiang Xue committed
19 20 21
 *
 * Beware, by definition cache storage are volatile, which means the data stored on them
 * may be swapped out and get lost. Therefore, you must make sure the cache used by this component
Qiang Xue committed
22
 * is NOT volatile. If you want to use database as storage medium, use [[DbSession]] is a better choice.
Qiang Xue committed
23 24
 *
 * @author Qiang Xue <qiang.xue@gmail.com>
Qiang Xue committed
25
 * @since 2.0
Qiang Xue committed
26 27 28 29
 */
class CacheSession extends Session
{
	/**
30 31 32 33 34
	 * @var Cache|string the cache object or the application component ID of the cache object.
	 * The session data will be stored using this cache object.
	 *
	 * After the CacheSession object is created, if you want to change this property,
	 * you should only assign it with a cache object.
Qiang Xue committed
35
	 */
36
	public $cache = 'cache';
Qiang Xue committed
37 38

	/**
39
	 * Initializes the application component.
Qiang Xue committed
40
	 */
41 42 43 44 45 46 47 48 49 50
	public function init()
	{
		parent::init();
		if (is_string($this->cache)) {
			$this->cache = Yii::$app->getComponent($this->cache);
		}
		if (!$this->cache instanceof Cache) {
			throw new InvalidConfigException('CacheSession::cache must refer to the application component ID of a cache object.');
		}
	}
Qiang Xue committed
51 52

	/**
Qiang Xue committed
53 54 55 56 57 58 59 60
	 * Returns a value indicating whether to use custom session storage.
	 * This method overrides the parent implementation and always returns true.
	 * @return boolean whether to use custom storage.
	 */
	public function getUseCustomStorage()
	{
		return true;
	}
Qiang Xue committed
61

Qiang Xue committed
62 63 64 65 66 67 68 69
	/**
	 * Session read handler.
	 * Do not call this method directly.
	 * @param string $id session ID
	 * @return string the session data
	 */
	public function readSession($id)
	{
70
		$data = $this->cache->get($this->calculateKey($id));
Qiang Xue committed
71 72 73 74 75 76 77 78 79 80 81 82
		return $data === false ? '' : $data;
	}

	/**
	 * Session write handler.
	 * Do not call this method directly.
	 * @param string $id session ID
	 * @param string $data session data
	 * @return boolean whether session write is successful
	 */
	public function writeSession($id, $data)
	{
83
		return $this->cache->set($this->calculateKey($id), $data, $this->getTimeout());
Qiang Xue committed
84 85 86 87 88 89 90 91 92 93
	}

	/**
	 * Session destroy handler.
	 * Do not call this method directly.
	 * @param string $id session ID
	 * @return boolean whether session is destroyed successfully
	 */
	public function destroySession($id)
	{
94
		return $this->cache->delete($this->calculateKey($id));
Qiang Xue committed
95 96 97 98 99
	}

	/**
	 * Generates a unique key used for storing session data in cache.
	 * @param string $id session variable name
100
	 * @return mixed a safe cache key associated with the session variable name
Qiang Xue committed
101 102 103
	 */
	protected function calculateKey($id)
	{
104
		return array(__CLASS__, $id);
Qiang Xue committed
105 106
	}
}