/**
* Executes a cacheable callback if not found in cache else returns cached output and result
*
* @param mixed $callback Callable or string shorthand for a callback
* @param array $args Callback arguments
* @param string $id Cache id
* @param boolean $wrkarounds True to use wrkarounds
* @param array $woptions Workaround options
*
* @return mixed Result of the callback
*
* @since 11.1
*/
public function get($callback, $args = array(), $id = false, $wrkarounds = false, $woptions = array())
{
// Normalize callback
if (is_array($callback)) {
// We have a standard php callback array -- do nothing
} elseif (strstr($callback, '::')) {
// This is shorthand for a static method callback classname::methodname
list($class, $method) = explode('::', $callback);
$callback = array(trim($class), trim($method));
} elseif (strstr($callback, '->')) {
/*
* This is a really not so smart way of doing this... we provide this for backward compatability but this
* WILL! disappear in a future version. If you are using this syntax change your code to use the standard
* PHP callback array syntax: <http://php.net/callback>
*
* We have to use some silly global notation to pull it off and this is very unreliable
*/
list($object_123456789, $method) = explode('->', $callback);
global ${$object_123456789};
$callback = array(${$object_123456789}, $method);
} else {
// We have just a standard function -- do nothing
}
if (!$id) {
// Generate an ID
$id = $this->_makeId($callback, $args);
}
$data = $this->cache->get($id);
$locktest = new stdClass();
$locktest->locked = null;
$locktest->locklooped = null;
if ($data === false) {
$locktest = $this->cache->lock($id);
if ($locktest->locked == true && $locktest->locklooped == true) {
$data = $this->cache->get($id);
}
}
$coptions = array();
if ($data !== false) {
$cached = unserialize(trim($data));
$coptions['mergehead'] = isset($woptions['mergehead']) ? $woptions['mergehead'] : 0;
$output = $wrkarounds == false ? $cached['output'] : Cache::getWorkarounds($cached['output'], $coptions);
$result = $cached['result'];
if ($locktest->locked == true) {
$this->cache->unlock($id);
}
} else {
if (!is_array($args)) {
$Args = !empty($args) ? array(&$args) : array();
} else {
$Args =& $args;
}
if ($locktest->locked == false) {
$locktest = $this->cache->lock($id);
}
if (isset($woptions['modulemode']) && $woptions['modulemode'] == 1) {
$document = Factory::getDocument();
$coptions['modulemode'] = 1;
$coptions['headerbefore'] = $document->getHeadData();
} else {
$coptions['modulemode'] = 0;
}
ob_start();
ob_implicit_flush(false);
$result = call_user_func_array($callback, $Args);
$output = ob_get_contents();
ob_end_clean();
$cached = array();
$coptions['nopathway'] = isset($woptions['nopathway']) ? $woptions['nopathway'] : 1;
$coptions['nohead'] = isset($woptions['nohead']) ? $woptions['nohead'] : 1;
$coptions['nomodules'] = isset($woptions['nomodules']) ? $woptions['nomodules'] : 1;
$cached['output'] = $wrkarounds == false ? $output : Cache::setWorkarounds($output, $coptions);
$cached['result'] = $result;
// Store the cache data
$this->cache->store(serialize($cached), $id);
if ($locktest->locked == true) {
$this->cache->unlock($id);
}
}
echo $output;
return $result;
}
/**
* Get the contents of a document include
*
* @param string $type The type of renderer
* @param string $name The name of the element to render
* @param array $attribs Associative array of remaining attributes.
*
* @return The output of the renderer
*
* @since 11.1
*/
public function getBuffer($type = null, $name = null, $attribs = array())
{
// If no type is specified, return the whole buffer
if ($type === null) {
return parent::$_buffer;
}
$title = isset($attribs['title']) ? $attribs['title'] : null;
if (isset(parent::$_buffer[$type][$name][$title])) {
return parent::$_buffer[$type][$name][$title];
}
$renderer = $this->loadRenderer($type);
if ($this->_caching == true && $type == 'modules') {
$cache = Factory::getCache('com_modules', '');
$hash = md5(serialize(array($name, $attribs, null, $renderer)));
$cbuffer = $cache->get('cbuffer_' . $type);
if (isset($cbuffer[$hash])) {
return Cache::getWorkarounds($cbuffer[$hash], array('mergehead' => 1));
} else {
$options = array();
$options['nopathway'] = 1;
$options['nomodules'] = 1;
$options['modulemode'] = 1;
$this->setBuffer($renderer->render($name, $attribs, null), $type, $name);
$data = parent::$_buffer[$type][$name][$title];
$tmpdata = Cache::setWorkarounds($data, $options);
$cbuffer[$hash] = $tmpdata;
$cache->store($cbuffer, 'cbuffer_' . $type);
}
} else {
$this->setBuffer($renderer->render($name, $attribs, null), $type, $name, $title);
}
return parent::$_buffer[$type][$name][$title];
}
/**
* Stop the cache buffer and store the cached data
*
* @param boolean $wrkarounds True to use wrkarounds
*
* @return boolean True if cache stored
*
* @since 11.1
*/
public function store($wrkarounds = true)
{
// Get page data from JResponse body
$data = Response::getBody();
// Get id and group and reset the placeholders
$id = $this->_id;
$group = $this->_group;
$this->_id = null;
$this->_group = null;
// Only attempt to store if page data exists
if ($data) {
$data = $wrkarounds == false ? $data : Cache::setWorkarounds($data);
if ($this->_locktest->locked == false) {
$this->_locktest = $this->cache->lock($id, $group);
}
$sucess = $this->cache->store(serialize($data), $id, $group);
if ($this->_locktest->locked == true) {
$this->cache->unlock($id, $group);
}
return $sucess;
}
return false;
}
/**
* Get the cached view data
*
* @param object &$view The view object to cache output for
* @param string $method The method name of the view method to cache output for
* @param string $id The cache data id
* @param boolean $wrkarounds True to enable workarounds.
*
* @return boolean True if the cache is hit (false else)
*
* @since 11.1
*/
public function get(&$view, $method, $id = false, $wrkarounds = true)
{
// If an id is not given generate it from the request
if ($id == false) {
$id = $this->_makeId($view, $method);
}
$data = $this->cache->get($id);
$locktest = new stdClass();
$locktest->locked = null;
$locktest->locklooped = null;
if ($data === false) {
$locktest = $this->cache->lock($id, null);
// If the loop is completed and returned true it means the lock has been set.
// If looped is true try to get the cached data again; it could exist now.
if ($locktest->locked == true && $locktest->locklooped == true) {
$data = $this->cache->get($id);
}
// False means that locking is either turned off or maxtime has been exceeded.
// Execute the view.
}
if ($data !== false) {
$data = unserialize(trim($data));
if ($wrkarounds === true) {
echo Cache::getWorkarounds($data);
} else {
// No workarounds, so all data is stored in one piece
echo isset($data) ? $data : null;
}
if ($locktest->locked == true) {
$this->cache->unlock($id);
}
return true;
}
/*
* No hit so we have to execute the view
*/
if (method_exists($view, $method)) {
// If previous lock failed try again
if ($locktest->locked == false) {
$locktest = $this->cache->lock($id);
}
// Capture and echo output
ob_start();
ob_implicit_flush(false);
$view->{$method}();
$data = ob_get_contents();
ob_end_clean();
echo $data;
/*
* For a view we have a special case. We need to cache not only the output from the view, but the state
* of the document head after the view has been rendered. This will allow us to properly cache any attached
* scripts or stylesheets or links or any other modifications that the view has made to the document object
*/
$cached = array();
$cached = $wrkarounds == true ? Cache::setWorkarounds($data) : $data;
// Store the cache data
$this->cache->store(serialize($cached), $id);
if ($locktest->locked == true) {
$this->cache->unlock($id);
}
}
return false;
}