Files
crm.e5.pl/include/utils/external_cache/SugarCache.php
2024-04-27 09:23:34 +02:00

221 lines
9.6 KiB
PHP
Executable File

<?php
if(!defined('sugarEntry') || !sugarEntry) die('Not A Valid Entry Point');
/*********************************************************************************
* SugarCRM is a customer relationship management program developed by
* SugarCRM, Inc. Copyright (C) 2004-2010 SugarCRM Inc.
*
* This program is free software; you can redistribute it and/or modify it under
* the terms of the GNU Affero General Public License version 3 as published by the
* Free Software Foundation with the addition of the following permission added
* to Section 15 as permitted in Section 7(a): FOR ANY PART OF THE COVERED WORK
* IN WHICH THE COPYRIGHT IS OWNED BY SUGARCRM, SUGARCRM DISCLAIMS THE WARRANTY
* OF NON INFRINGEMENT OF THIRD PARTY RIGHTS.
*
* This program is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
* details.
*
* You should have received a copy of the GNU Affero General Public License along with
* this program; if not, see http://www.gnu.org/licenses or write to the Free
* Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
* 02110-1301 USA.
*
* You can contact SugarCRM, Inc. headquarters at 10050 North Wolfe Road,
* SW2-130, Cupertino, CA 95014, USA. or at email address contact@sugarcrm.com.
*
* The interactive user interfaces in modified source and object code versions
* of this program must display Appropriate Legal Notices, as required under
* Section 5 of the GNU Affero General Public License version 3.
*
* In accordance with Section 7(b) of the GNU Affero General Public License version 3,
* these Appropriate Legal Notices must retain the display of the "Powered by
* SugarCRM" logo. If the display of the logo is not reasonably feasible for
* technical reasons, the Appropriate Legal Notices must display the words
* "Powered by SugarCRM".
********************************************************************************/
class SugarCache
{
/**
* Discover and return available cache adapter of false if nothing is available
*
* @return SugarCache_Abstract|false
*/
function discover()
{
// If the cache is manually disabled, turn it off.
if(!empty($GLOBALS['sugar_config']['external_cache_disabled']) && true == $GLOBALS['sugar_config']['external_cache_disabled'])
{
if (EXTERNAL_CACHE_DEBUG) {
SugarCache::log("SugarCache::discover() -- caching explicitly disabled", 'fail');
}
$GLOBALS['external_cache_enabled'] = false;
return SugarCache::factory('Base');
}
// check for Zend caching
if(function_exists("output_cache_get") && empty($GLOBALS['sugar_config']['external_cache_disabled_zend']))
{
$GLOBALS['external_cache_enabled'] = true;
$GLOBALS['external_cache_type'] = "zend";
$cache = SugarCache::factory('Zend');
if (EXTERNAL_CACHE_DEBUG) {
SugarCache::log('Found Zend - attempting to use', 'pass');
}
}
elseif (extension_loaded('memcache') && empty($GLOBALS['sugar_config']['external_cache_disabled_memcache'])) {
$GLOBALS['external_cache_enabled'] = true;
$GLOBALS['external_cache_type'] = 'memcache';
$cache = SugarCache::factory('Memcache');
if (EXTERNAL_CACHE_DEBUG) {
SugarCache::log('Found memcache - attempting to use', 'pass');
}
}
elseif(function_exists("apc_store") && empty($GLOBALS['sugar_config']['external_cache_disabled_apc']))
{
$GLOBALS['external_cache_enabled'] = true;
$GLOBALS['external_cache_type'] = "apc";
$cache = SugarCache::factory('APC');
if (EXTERNAL_CACHE_DEBUG) {
SugarCache::log('Found APC - attempting to use', 'pass');
}
}
elseif(function_exists("wincache_ucache_set") && empty($GLOBALS['sugar_config']['external_cache_disabled_wincache']))
{
$GLOBALS['external_cache_enabled'] = true;
$GLOBALS['external_cache_type'] = "wincache";
$cache = SugarCache::factory('Wincache');
if (EXTERNAL_CACHE_DEBUG) {
SugarCache::log('Found Wincache - attempting to use', 'pass');
}
}
elseif(function_exists("zget") && empty($GLOBALS['sugar_config']['external_cache_disabled_smash']))
{
$GLOBALS['external_cache_enabled'] = true;
$GLOBALS['external_cache_type'] = "smash";
$cache = SugarCache::factory('sMash');
if (EXTERNAL_CACHE_DEBUG) {
SugarCache::log('Found sMash - attempting to use', 'pass');
}
}
// @todo memcache
// @todo file cache as fallback
else
{
// no cache available....return
$GLOBALS['external_cache_enabled'] = true;
$GLOBALS['external_cache_type'] = 'base-in-memory';
$cache = SugarCache::factory('Base');
if (EXTERNAL_CACHE_DEBUG) {
SugarCache::log('Found no caching solution - using base');
}
}
// Check the cache.
if(!$cache->initialized)
{
// Validation failed. Turn off the external cache and return SugarCache_Base
$GLOBALS['external_cache_enabled'] = false;
if(EXTERNAL_CACHE_DEBUG) {
SugarCache::log("external cache validation check failed...tried cache {$GLOBALS['external_cache_type']}", 'fail');
SugarCache::log('returning Base');
}
return SugarCache::factory('Base');
}
// If the cache is being reset, turn it off for this round trip
$value = '';
if(isset($GLOBALS['sugar_config']) && isset($GLOBALS['sugar_config']['unique_key']))
{
$value = $cache->get($GLOBALS['sugar_config']['unique_key'].'EXTERNAL_CACHE_RESET');
}
if(!empty($value))
{
// We are in a cache reset, do not use the cache.
$GLOBALS['external_cache_enabled'] = false;
}
else
{
// Add one to the external cache hits. This will keep the end user statistics simple.
// All real checks suceeding will result in 100%. Otherwise people will be looking for
// the one check that did not pass.
$GLOBALS['external_cache_request_external_hits']++;
}
return $cache;
}
function factory($type)
{
$class = 'SugarCache_' . $type;
$cache = new $class();
$cache->init();
return $cache;
}
/**
* Performs basic logging for messages generated by the external caching mechanism
*
* Currently this only outputs directly to the screen as it's only used internally.
*
* There are five supported $type values:
* neutral :: just a log message with information value
* pass :: a pass that attention should be brought to
* lightpass :: a pass without much consequence
* fail :: a fail that attention should be brought to
* lightfail :: a failure without much consequence, or one that might succeed later in
* the execution chain
*
* @param string $msg Message to output. Note it will be filtered through htmlspecialchars()
* @param string $type Type of message to output
*/
function log($msg, $type = 'neutral') {
static $messages = array();
static $valid_types = array(
'neutral' => '',
'pass' => '',
'lightpass' => '',
'fail' => '',
'lightfail' => '',
);
if (!isset($valid_types[$type])) {
SugarCache::log("Invalid type provided: {$type}", 'fail');
$type = 'neutral';
}
$session_id = session_id();
if (empty($session_id)) {
// add to stack of messages to output after the session starts so we don't kill the headers
$messages[] = array(
'message' => htmlspecialchars($msg),
'type' => $type,
);
} else {
if ($messages !== false) {
// output base styles on first round trip - this doesn't worry that its
// not in the proper place as its for debugging purposes only.
echo "<style type='text/css'>"
. "hr +span { padding:3px 5px; display:block; } "
. "hr +.pass { background-color:green; color: white; } "
. "hr +.lightpass { background-color: #CFC; color:black; }"
. "hr +.fail { background-color:red; color:white; } "
. "hr +.lightfail { background-color:#F99; color: black; }"
. "hr +.neutral { background-color:#FFFFE0; color:black; } "
. "</style>";
}
if ($messages !== false && count($messages) > 0) {
// clear stack of messages;
echo '<hr />Messages logged prior to session starting...<hr />', "\n";
foreach ($messages as $id => $old_msg) {
echo "<hr /><span class='{$old_msg['type']}'>{$id} -- {$old_msg['message']}</span><hr />\n";
}
echo "<hr />End of messages prior to session starting...<hr />\n";
}
$messages = false;
$msg = htmlspecialchars($msg);
echo "<hr /><span class='{$type}'>{$msg}</span><hr />\n";
}
}
}