1: <?php
2:
3: 4: 5: 6: 7: 8: 9: 10:
11:
12: namespace Nette\Caching;
13:
14: use Nette;
15:
16:
17:
18: 19: 20: 21: 22: 23: 24: 25:
26: class Cache extends Nette\Object implements \ArrayAccess
27: {
28:
29: const PRIORITY = 'priority',
30: EXPIRATION = 'expire',
31: EXPIRE = 'expire',
32: SLIDING = 'sliding',
33: TAGS = 'tags',
34: FILES = 'files',
35: ITEMS = 'items',
36: CONSTS = 'consts',
37: CALLBACKS = 'callbacks',
38: ALL = 'all';
39:
40:
41: const NAMESPACE_SEPARATOR = "\x00";
42:
43:
44: private $storage;
45:
46:
47: private $namespace;
48:
49:
50: private $key;
51:
52:
53: private $data;
54:
55:
56:
57: public function __construct(IStorage $storage, $namespace = NULL)
58: {
59: $this->storage = $storage;
60: $this->namespace = $namespace . self::NAMESPACE_SEPARATOR;
61: }
62:
63:
64:
65: 66: 67: 68:
69: public function getStorage()
70: {
71: return $this->storage;
72: }
73:
74:
75:
76: 77: 78: 79:
80: public function getNamespace()
81: {
82: return (string) substr($this->namespace, 0, -1);
83: }
84:
85:
86:
87: 88: 89: 90: 91:
92: public function derive($namespace)
93: {
94: $derived = new static($this->storage, $this->namespace . $namespace);
95: return $derived;
96: }
97:
98:
99:
100: 101: 102: 103: 104: 105:
106: public function load($key, $fallback = NULL)
107: {
108: $data = $this->storage->read($this->generateKey($key));
109: if ($data === NULL && $fallback) {
110: return $this->save($key, new Nette\Callback($fallback));
111: }
112: return $data;
113: }
114:
115:
116:
117: 118: 119: 120: 121: 122: 123: 124: 125: 126: 127: 128: 129: 130: 131: 132: 133:
134: public function save($key, $data, array $dependencies = NULL)
135: {
136: $this->release();
137: $key = $this->generateKey($key);
138:
139: if ($data instanceof Nette\Callback || $data instanceof \Closure) {
140: $this->storage->lock($key);
141: $data = Nette\Callback::create($data)->invokeArgs(array(&$dependencies));
142: }
143:
144: if ($data === NULL) {
145: $this->storage->remove($key);
146: } else {
147: $this->storage->write($key, $data, $this->completeDependencies($dependencies, $data));
148: return $data;
149: }
150: }
151:
152:
153:
154: private function completeDependencies($dp, $data)
155: {
156: if (is_object($data)) {
157: $dp[self::CALLBACKS][] = array(array(__CLASS__, 'checkSerializationVersion'), get_class($data),
158: Nette\Reflection\ClassType::from($data)->getAnnotation('serializationVersion'));
159: }
160:
161:
162: if (isset($dp[Cache::EXPIRATION])) {
163: $dp[Cache::EXPIRATION] = Nette\DateTime::from($dp[Cache::EXPIRATION])->format('U') - time();
164: }
165:
166:
167: if (isset($dp[self::FILES])) {
168:
169: foreach (array_unique((array) $dp[self::FILES]) as $item) {
170: $dp[self::CALLBACKS][] = array(array(__CLASS__, 'checkFile'), $item, @filemtime($item));
171: }
172: unset($dp[self::FILES]);
173: }
174:
175:
176: if (isset($dp[self::ITEMS])) {
177: $dp[self::ITEMS] = array_unique(array_map(array($this, 'generateKey'), (array) $dp[self::ITEMS]));
178: }
179:
180:
181: if (isset($dp[self::CONSTS])) {
182: foreach (array_unique((array) $dp[self::CONSTS]) as $item) {
183: $dp[self::CALLBACKS][] = array(array(__CLASS__, 'checkConst'), $item, constant($item));
184: }
185: unset($dp[self::CONSTS]);
186: }
187:
188: if (!is_array($dp)) {
189: $dp = array();
190: }
191: return $dp;
192: }
193:
194:
195:
196: 197: 198: 199: 200:
201: public function remove($key)
202: {
203: $this->save($key, NULL);
204: }
205:
206:
207:
208: 209: 210: 211: 212: 213: 214: 215:
216: public function clean(array $conditions = NULL)
217: {
218: $this->release();
219: $this->storage->clean((array) $conditions);
220: }
221:
222:
223:
224: 225: 226: 227: 228:
229: public function call($function)
230: {
231: $key = func_get_args();
232: return $this->load($key, function() use ($function, $key) {
233: array_shift($key);
234: return Nette\Callback::create($function)->invokeArgs($key);
235: });
236: }
237:
238:
239:
240: 241: 242: 243: 244: 245:
246: public function wrap($function, array $dependencies = NULL)
247: {
248: $cache = $this;
249: return function() use ($cache, $function, $dependencies) {
250: $key = array($function, func_get_args());
251: $data = $cache->load($key);
252: if ($data === NULL) {
253: $data = $cache->save($key, Nette\Callback::create($function)->invokeArgs($key[1]), $dependencies);
254: }
255: return $data;
256: };
257: }
258:
259:
260:
261: 262: 263: 264: 265:
266: public function start($key)
267: {
268: $data = $this->load($key);
269: if ($data === NULL) {
270: return new OutputHelper($this, $key);
271: }
272: echo $data;
273: }
274:
275:
276:
277: 278: 279: 280: 281: 282:
283: protected function generateKey($key)
284: {
285: return $this->namespace . md5(is_scalar($key) ? $key : serialize($key));
286: }
287:
288:
289:
290:
291:
292:
293:
294: 295: 296: 297: 298: 299: 300:
301: public function offsetSet($key, $data)
302: {
303: $this->save($key, $data);
304: }
305:
306:
307:
308: 309: 310: 311: 312: 313:
314: public function offsetGet($key)
315: {
316: $key = is_scalar($key) ? (string) $key : serialize($key);
317: if ($this->key !== $key) {
318: $this->key = $key;
319: $this->data = $this->load($key);
320: }
321: return $this->data;
322: }
323:
324:
325:
326: 327: 328: 329: 330: 331:
332: public function offsetExists($key)
333: {
334: $this->release();
335: return $this->offsetGet($key) !== NULL;
336: }
337:
338:
339:
340: 341: 342: 343: 344: 345:
346: public function offsetUnset($key)
347: {
348: $this->save($key, NULL);
349: }
350:
351:
352:
353: 354: 355: 356:
357: public function release()
358: {
359: $this->key = $this->data = NULL;
360: }
361:
362:
363:
364:
365:
366:
367:
368: 369: 370: 371: 372:
373: public static function checkCallbacks($callbacks)
374: {
375: foreach ($callbacks as $callback) {
376: $func = array_shift($callback);
377: if (!call_user_func_array($func, $callback)) {
378: return FALSE;
379: }
380: }
381: return TRUE;
382: }
383:
384:
385:
386: 387: 388: 389: 390: 391:
392: private static function checkConst($const, $value)
393: {
394: return defined($const) && constant($const) === $value;
395: }
396:
397:
398:
399: 400: 401: 402: 403: 404:
405: private static function checkFile($file, $time)
406: {
407: return @filemtime($file) == $time;
408: }
409:
410:
411:
412: 413: 414: 415: 416: 417:
418: private static function checkSerializationVersion($class, $value)
419: {
420: return Nette\Reflection\ClassType::from($class)->getAnnotation('serializationVersion') === $value;
421: }
422:
423: }
424: