2008-05-30 11:40:08 +00:00
|
|
|
<?php
|
|
|
|
/**
|
|
|
|
* APC storage engine for cache.
|
|
|
|
*
|
|
|
|
*
|
2010-10-03 16:38:58 +00:00
|
|
|
* PHP 5
|
2008-05-30 11:40:08 +00:00
|
|
|
*
|
2009-11-06 06:46:59 +00:00
|
|
|
* CakePHP(tm) : Rapid Development Framework (http://cakephp.org)
|
2012-03-13 02:46:07 +00:00
|
|
|
* Copyright 2005-2012, Cake Software Foundation, Inc. (http://cakefoundation.org)
|
2008-05-30 11:40:08 +00:00
|
|
|
*
|
|
|
|
* Licensed under The MIT License
|
|
|
|
* Redistributions of files must retain the above copyright notice.
|
|
|
|
*
|
2012-03-13 02:46:07 +00:00
|
|
|
* @copyright Copyright 2005-2012, Cake Software Foundation, Inc. (http://cakefoundation.org)
|
2009-11-06 06:00:11 +00:00
|
|
|
* @link http://cakephp.org CakePHP(tm) Project
|
2011-07-26 06:16:14 +00:00
|
|
|
* @package Cake.Cache.Engine
|
2008-10-30 17:30:26 +00:00
|
|
|
* @since CakePHP(tm) v 1.2.0.4933
|
2009-11-06 06:51:51 +00:00
|
|
|
* @license MIT License (http://www.opensource.org/licenses/mit-license.php)
|
2008-05-30 11:40:08 +00:00
|
|
|
*/
|
2009-07-24 19:18:37 +00:00
|
|
|
|
2008-05-30 11:40:08 +00:00
|
|
|
/**
|
|
|
|
* APC storage engine for cache
|
|
|
|
*
|
2011-07-26 06:16:14 +00:00
|
|
|
* @package Cake.Cache.Engine
|
2008-05-30 11:40:08 +00:00
|
|
|
*/
|
|
|
|
class ApcEngine extends CacheEngine {
|
2009-07-24 19:18:37 +00:00
|
|
|
|
2012-03-27 03:32:26 +00:00
|
|
|
/**
|
|
|
|
* Contains the compiled group names
|
|
|
|
* (prefixed witht the global configuration prefix)
|
|
|
|
*
|
|
|
|
* @var array
|
|
|
|
**/
|
|
|
|
protected $_compiledGroupNames = array();
|
|
|
|
|
2008-05-30 11:40:08 +00:00
|
|
|
/**
|
|
|
|
* Initialize the Cache Engine
|
|
|
|
*
|
|
|
|
* Called automatically by the cache frontend
|
|
|
|
* To reinitialize the settings call Cache::engine('EngineName', [optional] settings = array());
|
|
|
|
*
|
2011-04-17 06:13:03 +00:00
|
|
|
* @param array $settings array of setting for the engine
|
2008-05-30 11:40:08 +00:00
|
|
|
* @return boolean True if the engine has been successfully initialized, false if not
|
|
|
|
* @see CacheEngine::__defaults
|
|
|
|
*/
|
2010-04-05 03:19:38 +00:00
|
|
|
public function init($settings = array()) {
|
2012-04-24 03:59:32 +00:00
|
|
|
if (!isset($settings['prefix'])) {
|
|
|
|
$settings['prefix'] = Inflector::slug(APP_DIR) . '_';
|
|
|
|
}
|
|
|
|
$settings += array('engine' => 'Apc');
|
|
|
|
parent::init($settings);
|
2011-10-19 00:48:58 +00:00
|
|
|
return function_exists('apc_dec');
|
2008-05-30 11:40:08 +00:00
|
|
|
}
|
2009-07-24 19:18:37 +00:00
|
|
|
|
2008-05-30 11:40:08 +00:00
|
|
|
/**
|
|
|
|
* Write data for key into cache
|
|
|
|
*
|
|
|
|
* @param string $key Identifier for the data
|
|
|
|
* @param mixed $value Data to be cached
|
|
|
|
* @param integer $duration How long to cache the data, in seconds
|
2011-04-17 06:13:03 +00:00
|
|
|
* @return boolean True if the data was successfully cached, false on failure
|
2008-05-30 11:40:08 +00:00
|
|
|
*/
|
2010-04-18 04:57:52 +00:00
|
|
|
public function write($key, $value, $duration) {
|
2011-07-02 00:26:20 +00:00
|
|
|
if ($duration == 0) {
|
|
|
|
$expires = 0;
|
|
|
|
} else {
|
|
|
|
$expires = time() + $duration;
|
|
|
|
}
|
2012-03-03 22:34:13 +00:00
|
|
|
apc_store($key . '_expires', $expires, $duration);
|
2008-05-30 11:40:08 +00:00
|
|
|
return apc_store($key, $value, $duration);
|
|
|
|
}
|
2009-07-24 19:18:37 +00:00
|
|
|
|
2008-05-30 11:40:08 +00:00
|
|
|
/**
|
|
|
|
* Read a key from the cache
|
|
|
|
*
|
|
|
|
* @param string $key Identifier for the data
|
|
|
|
* @return mixed The cached data, or false if the data doesn't exist, has expired, or if there was an error fetching it
|
|
|
|
*/
|
2010-04-05 03:19:38 +00:00
|
|
|
public function read($key) {
|
2008-07-26 20:00:20 +00:00
|
|
|
$time = time();
|
2012-03-03 22:34:13 +00:00
|
|
|
$cachetime = intval(apc_fetch($key . '_expires'));
|
2011-07-02 00:26:20 +00:00
|
|
|
if ($cachetime !== 0 && ($cachetime < $time || ($time + $this->settings['duration']) < $cachetime)) {
|
2008-07-26 20:00:20 +00:00
|
|
|
return false;
|
|
|
|
}
|
2008-05-30 11:40:08 +00:00
|
|
|
return apc_fetch($key);
|
|
|
|
}
|
2009-07-24 19:18:37 +00:00
|
|
|
|
2010-01-21 16:41:44 +00:00
|
|
|
/**
|
|
|
|
* Increments the value of an integer cached key
|
|
|
|
*
|
|
|
|
* @param string $key Identifier for the data
|
|
|
|
* @param integer $offset How much to increment
|
|
|
|
* @return New incremented value, false otherwise
|
|
|
|
*/
|
2010-04-05 03:19:38 +00:00
|
|
|
public function increment($key, $offset = 1) {
|
2010-01-21 16:41:44 +00:00
|
|
|
return apc_inc($key, $offset);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Decrements the value of an integer cached key
|
|
|
|
*
|
|
|
|
* @param string $key Identifier for the data
|
2011-04-17 06:13:03 +00:00
|
|
|
* @param integer $offset How much to subtract
|
2010-01-21 16:41:44 +00:00
|
|
|
* @return New decremented value, false otherwise
|
|
|
|
*/
|
2010-04-05 03:19:38 +00:00
|
|
|
public function decrement($key, $offset = 1) {
|
2010-01-21 16:41:44 +00:00
|
|
|
return apc_dec($key, $offset);
|
|
|
|
}
|
|
|
|
|
2008-05-30 11:40:08 +00:00
|
|
|
/**
|
|
|
|
* Delete a key from the cache
|
|
|
|
*
|
|
|
|
* @param string $key Identifier for the data
|
2011-04-17 06:13:03 +00:00
|
|
|
* @return boolean True if the value was successfully deleted, false if it didn't exist or couldn't be removed
|
2008-05-30 11:40:08 +00:00
|
|
|
*/
|
2010-04-05 03:19:38 +00:00
|
|
|
public function delete($key) {
|
2008-05-30 11:40:08 +00:00
|
|
|
return apc_delete($key);
|
|
|
|
}
|
2009-07-24 19:18:37 +00:00
|
|
|
|
2008-05-30 11:40:08 +00:00
|
|
|
/**
|
2010-09-18 16:52:08 +00:00
|
|
|
* Delete all keys from the cache. This will clear every cache config using APC.
|
2008-05-30 11:40:08 +00:00
|
|
|
*
|
2011-08-20 03:13:52 +00:00
|
|
|
* @param boolean $check If true, nothing will be cleared, as entries are removed
|
|
|
|
* from APC as they expired. This flag is really only used by FileEngine.
|
2011-08-20 13:25:53 +00:00
|
|
|
* @return boolean True Returns true.
|
2008-05-30 11:40:08 +00:00
|
|
|
*/
|
2010-04-18 04:57:52 +00:00
|
|
|
public function clear($check) {
|
2011-08-20 03:13:52 +00:00
|
|
|
if ($check) {
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
$info = apc_cache_info('user');
|
|
|
|
$cacheKeys = $info['cache_list'];
|
|
|
|
unset($info);
|
|
|
|
foreach ($cacheKeys as $key) {
|
|
|
|
if (strpos($key['info'], $this->settings['prefix']) === 0) {
|
|
|
|
apc_delete($key['info']);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
return true;
|
2008-05-30 11:40:08 +00:00
|
|
|
}
|
2010-04-18 04:57:52 +00:00
|
|
|
|
2012-03-25 23:47:08 +00:00
|
|
|
/**
|
|
|
|
* Returns the `group value` for each of the configured groups
|
|
|
|
* If the group initial value was not found, then it initializes
|
|
|
|
* the group accordingly.
|
|
|
|
*
|
|
|
|
* @return array
|
|
|
|
**/
|
|
|
|
public function groups() {
|
2012-03-27 04:31:34 +00:00
|
|
|
if (empty($this->_compiledGroupNames)) {
|
2012-03-27 03:32:26 +00:00
|
|
|
foreach ($this->settings['groups'] as $group) {
|
2012-03-27 04:31:34 +00:00
|
|
|
$this->_compiledGroupNames[] = $this->settings['prefix'] . $group;
|
2012-03-27 03:32:26 +00:00
|
|
|
}
|
|
|
|
}
|
2012-03-25 23:47:08 +00:00
|
|
|
|
2012-03-27 04:31:34 +00:00
|
|
|
$groups = apc_fetch($this->_compiledGroupNames);
|
2012-03-25 23:47:08 +00:00
|
|
|
if (count($groups) !== count($this->settings['groups'])) {
|
2012-03-27 03:32:26 +00:00
|
|
|
foreach ($this->_compiledGroupNames as $group) {
|
2012-03-25 23:47:08 +00:00
|
|
|
if (!isset($groups[$group])) {
|
|
|
|
apc_store($group, 1);
|
|
|
|
$groups[$group] = 1;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
ksort($groups);
|
|
|
|
}
|
|
|
|
|
|
|
|
$result = array();
|
2012-03-27 04:31:34 +00:00
|
|
|
$groups = array_values($groups);
|
|
|
|
foreach ($this->settings['groups'] as $i => $group) {
|
|
|
|
$result[] = $group . $groups[$i];
|
2012-03-25 23:47:08 +00:00
|
|
|
}
|
|
|
|
return $result;
|
|
|
|
}
|
2012-03-26 00:15:32 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Increments the group value to simulate deletion of all keys under a group
|
2012-03-26 04:59:02 +00:00
|
|
|
* old values will remain in storage until they expire.
|
2012-03-26 00:15:32 +00:00
|
|
|
*
|
|
|
|
* @return boolean success
|
|
|
|
**/
|
|
|
|
public function clearGroup($group) {
|
2012-03-27 03:32:26 +00:00
|
|
|
apc_inc($this->settings['prefix'] . $group, 1, $success);
|
2012-03-26 00:15:32 +00:00
|
|
|
return $success;
|
|
|
|
}
|
|
|
|
|
2008-05-30 11:40:08 +00:00
|
|
|
}
|