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 $dp = 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(&$dp));
142: }
143:
144: if ($data === NULL) {
145: $this->storage->remove($key);
146: } else {
147: $this->storage->write($key, $data, $this->completeDependencies($dp, $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: 217:
218: public function clean(array $conds = NULL)
219: {
220: $this->release();
221: $this->storage->clean((array) $conds);
222: }
223:
224:
225:
226: 227: 228: 229: 230:
231: public function call($function)
232: {
233: $key = func_get_args();
234: return $this->load($key, function() use ($function, $key) {
235: array_shift($key);
236: return Nette\Callback::create($function)->invokeArgs($key);
237: });
238: }
239:
240:
241:
242: 243: 244: 245: 246: 247:
248: public function wrap($function, array $dp = NULL)
249: {
250: $cache = $this;
251: return function() use ($cache, $function, $dp) {
252: $key = array($function, func_get_args());
253: $data = $cache->load($key);
254: if ($data === NULL) {
255: $data = $cache->save($key, Nette\Callback::create($function)->invokeArgs($key[1]), $dp);
256: }
257: return $data;
258: };
259: }
260:
261:
262:
263: 264: 265: 266: 267:
268: public function start($key)
269: {
270: $data = $this->load($key);
271: if ($data === NULL) {
272: return new OutputHelper($this, $key);
273: }
274: echo $data;
275: }
276:
277:
278:
279: 280: 281: 282: 283: 284:
285: protected function generateKey($key)
286: {
287: return $this->namespace . md5(is_scalar($key) ? $key : serialize($key));
288: }
289:
290:
291:
292:
293:
294:
295:
296: 297: 298: 299: 300: 301: 302:
303: public function offsetSet($key, $data)
304: {
305: $this->save($key, $data);
306: }
307:
308:
309:
310: 311: 312: 313: 314: 315:
316: public function offsetGet($key)
317: {
318: $key = is_scalar($key) ? (string) $key : serialize($key);
319: if ($this->key !== $key) {
320: $this->key = $key;
321: $this->data = $this->load($key);
322: }
323: return $this->data;
324: }
325:
326:
327:
328: 329: 330: 331: 332: 333:
334: public function offsetExists($key)
335: {
336: $this->release();
337: return $this->offsetGet($key) !== NULL;
338: }
339:
340:
341:
342: 343: 344: 345: 346: 347:
348: public function offsetUnset($key)
349: {
350: $this->save($key, NULL);
351: }
352:
353:
354:
355: 356: 357: 358:
359: public function release()
360: {
361: $this->key = $this->data = NULL;
362: }
363:
364:
365:
366:
367:
368:
369:
370: 371: 372: 373: 374:
375: public static function checkCallbacks($callbacks)
376: {
377: foreach ($callbacks as $callback) {
378: $func = array_shift($callback);
379: if (!call_user_func_array($func, $callback)) {
380: return FALSE;
381: }
382: }
383: return TRUE;
384: }
385:
386:
387:
388: 389: 390: 391: 392: 393:
394: private static function checkConst($const, $value)
395: {
396: return defined($const) && constant($const) === $value;
397: }
398:
399:
400:
401: 402: 403: 404: 405: 406:
407: private static function checkFile($file, $time)
408: {
409: return @filemtime($file) == $time;
410: }
411:
412:
413:
414: 415: 416: 417: 418: 419:
420: private static function checkSerializationVersion($class, $value)
421: {
422: return Nette\Reflection\ClassType::from($class)->getAnnotation('serializationVersion') === $value;
423: }
424:
425: }
426: