blob: 0493d5a6eac8a7de6eaa7d46d50a96f324e43d3a [file] [log] [blame]
Andrey Andreev7d4ea072011-12-25 19:23:50 +02001<?php if ( ! defined('BASEPATH')) exit('No direct script access allowed');
Greg Akerbde25d92010-12-21 09:31:21 -06002/**
3 * CodeIgniter
4 *
Phil Sturgeon07c1ac82012-03-09 17:03:37 +00005 * An open source application development framework for PHP 5.2.4 or newer
Derek Jonesf4a4bd82011-10-20 12:18:42 -05006 *
7 * NOTICE OF LICENSE
Andrey Andreev7d4ea072011-12-25 19:23:50 +02008 *
Derek Jonesf4a4bd82011-10-20 12:18:42 -05009 * Licensed under the Open Software License version 3.0
Andrey Andreev7d4ea072011-12-25 19:23:50 +020010 *
Derek Jonesf4a4bd82011-10-20 12:18:42 -050011 * This source file is subject to the Open Software License (OSL 3.0) that is
12 * bundled with this package in the files license.txt / license.rst. It is
13 * also available through the world wide web at this URL:
14 * http://opensource.org/licenses/OSL-3.0
15 * If you did not receive a copy of the license and are unable to obtain it
16 * through the world wide web, please send an email to
17 * licensing@ellislab.com so we can send you a copy immediately.
Greg Akerbde25d92010-12-21 09:31:21 -060018 *
19 * @package CodeIgniter
Derek Jonesf4a4bd82011-10-20 12:18:42 -050020 * @author EllisLab Dev Team
Greg Aker0defe5d2012-01-01 18:46:41 -060021 * @copyright Copyright (c) 2006 - 2012 EllisLab, Inc.
Derek Jonesf4a4bd82011-10-20 12:18:42 -050022 * @license http://opensource.org/licenses/OSL-3.0 Open Software License (OSL 3.0)
Greg Akerbde25d92010-12-21 09:31:21 -060023 * @link http://codeigniter.com
24 * @since Version 2.0
Andrey Andreev7d4ea072011-12-25 19:23:50 +020025 * @filesource
Greg Akerbde25d92010-12-21 09:31:21 -060026 */
27
Greg Akerbde25d92010-12-21 09:31:21 -060028/**
Andrey Andreev7d4ea072011-12-25 19:23:50 +020029 * CodeIgniter Caching Class
Greg Akerbde25d92010-12-21 09:31:21 -060030 *
31 * @package CodeIgniter
32 * @subpackage Libraries
33 * @category Core
Derek Jonesf4a4bd82011-10-20 12:18:42 -050034 * @author EllisLab Dev Team
Andrey Andreev7d4ea072011-12-25 19:23:50 +020035 * @link
Greg Akerbde25d92010-12-21 09:31:21 -060036 */
Phil Sturgeoneb2dcda2011-04-02 14:44:58 +010037class CI_Cache extends CI_Driver_Library {
Andrey Andreev7d4ea072011-12-25 19:23:50 +020038
Timothy Warren0688ac92012-04-20 10:25:04 -040039 /**
40 * Valid cache drivers
41 *
42 * @var array
43 */
44 protected $valid_drivers = array(
45 'cache_apc',
46 'cache_file',
47 'cache_memcached',
48 'cache_dummy',
49 'cache_wincache'
50 );
Greg Akerbde25d92010-12-21 09:31:21 -060051
Timothy Warren0688ac92012-04-20 10:25:04 -040052 /**
53 * Path of cache files (if file-based cache)
54 *
55 * @var string
56 */
57 protected $_cache_path = NULL;
58
59 /**
60 * Reference to the driver
61 *
Timothy Warrenb82bc3a2012-04-27 09:12:58 -040062 * @var mixed
Timothy Warren0688ac92012-04-20 10:25:04 -040063 */
64 protected $_adapter = 'dummy';
65
66 /**
67 * Fallback driver
68 *
69 * @param string
70 */
Greg Akerbde25d92010-12-21 09:31:21 -060071 protected $_backup_driver;
Andrey Andreev7d4ea072011-12-25 19:23:50 +020072
Greg Akerbde25d92010-12-21 09:31:21 -060073 /**
Andrey Andreevb24b0332012-03-26 15:34:39 +030074 * Constructor
Greg Akerbde25d92010-12-21 09:31:21 -060075 *
76 * Initialize class properties based on the configuration array.
77 *
Andrey Andreev7d4ea072011-12-25 19:23:50 +020078 * @param array
Andrey Andreevb24b0332012-03-26 15:34:39 +030079 * @return void
Greg Akerbde25d92010-12-21 09:31:21 -060080 */
Andrey Andreevb24b0332012-03-26 15:34:39 +030081 public function __construct($config = array())
Greg Aker03abee32011-12-25 00:31:29 -060082 {
Greg Akerbde25d92010-12-21 09:31:21 -060083 $default_config = array(
Timothy Warren0688ac92012-04-20 10:25:04 -040084 'adapter',
85 'memcached'
86 );
Greg Akerbde25d92010-12-21 09:31:21 -060087
88 foreach ($default_config as $key)
89 {
90 if (isset($config[$key]))
91 {
92 $param = '_'.$key;
93
94 $this->{$param} = $config[$key];
95 }
96 }
97
98 if (isset($config['backup']))
99 {
100 if (in_array('cache_'.$config['backup'], $this->valid_drivers))
101 {
102 $this->_backup_driver = $config['backup'];
103 }
104 }
105 }
106
107 // ------------------------------------------------------------------------
108
109 /**
Andrey Andreevb24b0332012-03-26 15:34:39 +0300110 * Get
111 *
112 * Look for a value in the cache. If it exists, return the data
113 * if not, return FALSE
114 *
115 * @param string
116 * @return mixed value that is stored/FALSE on failure
117 */
118 public function get($id)
119 {
120 return $this->{$this->_adapter}->get($id);
121 }
122
123 // ------------------------------------------------------------------------
124
125 /**
126 * Cache Save
127 *
128 * @param string Unique Key
129 * @param mixed Data to store
130 * @param int Length of time (in seconds) to cache the data
131 * @return bool true on success/false on failure
132 */
133 public function save($id, $data, $ttl = 60)
134 {
135 return $this->{$this->_adapter}->save($id, $data, $ttl);
136 }
137
138 // ------------------------------------------------------------------------
139
140 /**
141 * Delete from Cache
142 *
143 * @param mixed unique identifier of the item in the cache
144 * @return bool true on success/false on failure
145 */
146 public function delete($id)
147 {
148 return $this->{$this->_adapter}->delete($id);
149 }
150
151 // ------------------------------------------------------------------------
152
153 /**
154 * Clean the cache
155 *
156 * @return bool false on failure/true on success
157 */
158 public function clean()
159 {
160 return $this->{$this->_adapter}->clean();
161 }
162
163 // ------------------------------------------------------------------------
164
165 /**
166 * Cache Info
167 *
168 * @param string user/filehits
169 * @return mixed array on success, false on failure
170 */
171 public function cache_info($type = 'user')
172 {
173 return $this->{$this->_adapter}->cache_info($type);
174 }
175
176 // ------------------------------------------------------------------------
177
178 /**
179 * Get Cache Metadata
180 *
181 * @param mixed key to get cache metadata on
182 * @return mixed return value from child method
183 */
184 public function get_metadata($id)
185 {
186 return $this->{$this->_adapter}->get_metadata($id);
187 }
188
189 // ------------------------------------------------------------------------
190
191 /**
Greg Akerbde25d92010-12-21 09:31:21 -0600192 * Is the requested driver supported in this environment?
193 *
Andrey Andreevb24b0332012-03-26 15:34:39 +0300194 * @param string The driver to test.
195 * @return array
Greg Akerbde25d92010-12-21 09:31:21 -0600196 */
197 public function is_supported($driver)
198 {
199 static $support = array();
200
201 if ( ! isset($support[$driver]))
202 {
203 $support[$driver] = $this->{$driver}->is_supported();
204 }
205
206 return $support[$driver];
207 }
208
209 // ------------------------------------------------------------------------
210
211 /**
212 * __get()
213 *
Andrey Andreevb24b0332012-03-26 15:34:39 +0300214 * @param child
215 * @return object
Greg Akerbde25d92010-12-21 09:31:21 -0600216 */
217 public function __get($child)
218 {
219 $obj = parent::__get($child);
220
221 if ( ! $this->is_supported($child))
222 {
223 $this->_adapter = $this->_backup_driver;
224 }
225
226 return $obj;
227 }
Andrey Andreev7d4ea072011-12-25 19:23:50 +0200228
Greg Akerbde25d92010-12-21 09:31:21 -0600229}
Greg Akerbde25d92010-12-21 09:31:21 -0600230
231/* End of file Cache.php */
Andrey Andreevb24b0332012-03-26 15:34:39 +0300232/* Location: ./system/libraries/Cache/Cache.php */