Project

General

Profile

Download (19.7 KB)

Feature #23316 » 15306_v1.diff

Administrator Admin, 2010-07-30 16:14

View differences:

typo3/sysext/scheduler/tasks/class.tx_scheduler_cachingframeworkgarbagecollection.php (revision 0)
<?php
/***************************************************************
* Copyright notice
*
* (c) 2009-2010 Christian Kuhn <lolli@schwarzbu.ch>
* All rights reserved
*
* This script is part of the TYPO3 project. The TYPO3 project is
* free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* The GNU General Public License can be found at
* http://www.gnu.org/copyleft/gpl.html.
*
* This script 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 General Public License for more details.
*
* This copyright notice MUST APPEAR in all copies of the script!
***************************************************************/
/**
* Garbage collection of caching framework cache backends.
*
* This task finds all configured caching framework caches and
* calls the garbage collection of a cache if the cache backend
* is configured to be cleaned.
*
* @author Christian Kuhn <lolli@schwarzbu.ch>
* @package TYPO3
* @subpackage scheduler
*/
class tx_scheduler_CachingFrameworkGarbageCollection extends tx_scheduler_Task {
/**
* Backend types that should be cleaned up,
* set by additional field provider.
*
* @var array Selected backends to do garbage collection for
*/
public $selectedBackends = array();
/**
* Execute garbage collection, called by scheduler.
*
* @return void
*/
public function execute() {
// Global subarray with all configured caches
$cacheConfigurations = $GLOBALS['TYPO3_CONF_VARS']['SYS']['caching']['cacheConfigurations'];
if (is_array($cacheConfigurations)) {
// Iterate through configured caches and call garbage collection if
// backend is within selected backends in additonal field of task
foreach ($cacheConfigurations as $cacheName => $cacheConfiguration) {
// The cache backend used for this cache
$usedCacheBackend = $cacheConfiguration['backend'];
if (in_array($usedCacheBackend, $this->selectedBackends)) {
$this->callGarbageCollectionOfCache($cacheName, $cacheConfiguration);
}
}
}
$success = TRUE;
return($success);
}
/**
* Get an instance of cache and call garbage collection
*
* @param string Cache name
* @param array Cache configuration
*/
protected function callGarbageCollectionOfCache($cacheName, array $cacheConfiguration) {
// Get existing cache instance or create a new one
try {
$cache = $GLOBALS['typo3CacheManager']->getCache($cacheName);
} catch (t3lib_cache_exception_NoSuchCache $exception) {
$GLOBALS['typo3CacheFactory']->create(
$cacheName,
$cacheConfiguration['frontend'],
$cacheConfiguration['backend'],
$cacheConfiguration['options']
);
$cache = $GLOBALS['typo3CacheManager']->getCache($cacheName);
}
// Call garbage collection of this cache
$cache->collectGarbage();
}
} // End of class
if (defined('TYPO3_MODE') && $GLOBALS['TYPO3_CONF_VARS'][TYPO3_MODE]['XCLASS']['ext/scheduler/tasks/class.tx_scheduler_cachingframeworkgarbagecollection.php']) {
include_once($GLOBALS['TYPO3_CONF_VARS'][TYPO3_MODE]['XCLASS']['ext/scheduler/tasks/class.tx_scheduler_cachingframeworkgarbagecollection.php']);
}
?>
typo3/sysext/scheduler/tasks/class.tx_scheduler_cachingframeworkgarbagecollection_additionalfieldprovider.php (revision 0)
<?php
/***************************************************************
* Copyright notice
*
* (c) 2009-2010 Christian Kuhn <lolli@schwarzbu.ch>
* All rights reserved
*
* This script is part of the TYPO3 project. The TYPO3 project is
* free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* The GNU General Public License can be found at
* http://www.gnu.org/copyleft/gpl.html.
*
* This script 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 General Public License for more details.
*
* This copyright notice MUST APPEAR in all copies of the script!
***************************************************************/
/**
* Additional BE fields for caching framework garbage collection task.
* Creates a multi selectbox with all available cache backends to select from.
*
* @author Christian Kuhn <lolli@schwarzbu.ch>
* @package TYPO3
* @subpackage scheduler
*/
class tx_scheduler_CachingFrameworkGarbageCollection_AdditionalFieldProvider implements tx_scheduler_AdditionalFieldProvider {
/**
* Add a multi select box with all available cache backends.
*
* @param array Reference to the array containing the info used in the add/edit form
* @param object When editing, reference to the current task object. Null when adding.
* @param tx_scheduler_Module Reference to the calling object (Scheduler's BE module)
* @return array Array containg all the information pertaining to the additional fields
*/
public function getAdditionalFields(array &$taskInfo, $task, tx_scheduler_Module $parentObject) {
// Initialize selected fields
if (empty($taskInfo['scheduler_cachingFrameworkGarbageCollection_selectedBackends'])) {
$taskInfo['scheduler_cachingFrameworkGarbageCollection_selectedBackends'] = array();
if ($parentObject->CMD == 'add') {
// In case of new task, set to dbBackend if it's available
if (in_array('t3lib_cache_backend_DbBackend', $this->getRegisteredBackends())) {
$taskInfo['scheduler_cachingFrameworkGarbageCollection_selectedBackends'][] = 't3lib_cache_backend_DbBackend';
}
} elseif ($parentObject->CMD == 'edit') {
// In case of editing the task, set to currently selected value
$taskInfo['scheduler_cachingFrameworkGarbageCollection_selectedBackends'] = $task->selectedBackends;
}
}
$fieldName = 'tx_scheduler[scheduler_cachingFrameworkGarbageCollection_selectedBackends][]';
$fieldId = 'task_cachingFrameworkGarbageCollection_selectedBackends';
$fieldOptions = $this->getCacheBackendOptions($taskInfo['scheduler_cachingFrameworkGarbageCollection_selectedBackends']);
$fieldHtml =
'<select name="' . $fieldName . '" id="' . $fieldId . '" class="wide" size="10" multiple="multiple">' .
$fieldOptions .
'</select>';
$additionalFields[$fieldID] = array(
'code' => $fieldHtml,
'label' => 'LLL:EXT:scheduler/mod1/locallang.xml:label.cachingFrameworkGarbageCollection.selectBackends',
'cshKey' => '_MOD_tools_txschedulerM1',
'cshLabel' => $fieldId,
);
return $additionalFields;
}
/**
* Checks that all selected backends exist in available backend list
*
* @param array Reference to the array containing the data submitted by the user
* @param tx_scheduler_Module Reference to the calling object (Scheduler's BE module)
* @return boolean True if validation was ok (or selected class is not relevant), false otherwise
*/
public function validateAdditionalFields(array &$submittedData, tx_scheduler_Module $parentObject) {
$validData = TRUE;
$availableBackends = $this->getRegisteredBackends();
$invalidBackends = array_diff($submittedData['scheduler_cachingFrameworkGarbageCollection_selectedBackends'], $availableBackends);
if (!empty($invalidBackends)) {
$validData = FALSE;
}
return $validData;
}
/**
* Save selected backends in task object
*
* @param array Contains data submitted by the user
* @param tx_scheduler_Task Reference to the current task object
* @return void
*/
public function saveAdditionalFields(array $submittedData, tx_scheduler_Task $task) {
$task->selectedBackends = $submittedData['scheduler_cachingFrameworkGarbageCollection_selectedBackends'];
}
/**
* Build select options of available backends and set currently selected backends
*
* @param array Selected backends
* @return string HTML of selectbox options
*/
protected function getCacheBackendOptions(array $selectedBackends) {
$options = array();
$availableBackends = $this->getRegisteredBackends();
foreach ($availableBackends as $backendName) {
if (in_array($backendName, $selectedBackends)) {
$selected = ' selected="selected"';
} else {
$selected = '';
}
$options[] =
'<option value="' . $backendName . '"' . $selected . '>' .
$backendName .
'</option>';
}
return implode($options);
}
/**
* Get all registered caching framework backends
*
* @return array Registered backends
*/
protected function getRegisteredBackends() {
$backends = array();
if (is_array($GLOBALS['TYPO3_CONF_VARS']['SYS']['caching']['cacheBackends'])) {
$backends = $GLOBALS['TYPO3_CONF_VARS']['SYS']['caching']['cacheBackends'];
}
return array_keys($backends);
}
} // End of class
if (defined('TYPO3_MODE') && $TYPO3_CONF_VARS[TYPO3_MODE]['XCLASS']['ext/scheduler/tasks/class.tx_scheduler_cachingframeworkgarbagecollection_additionalfieldprovider.php']) {
include_once($TYPO3_CONF_VARS[TYPO3_MODE]['XCLASS']['ext/scheduler/tasks/class.tx_scheduler_cachingframeworkgarbagecollection_additionalfieldprovider.php']);
}
?>
typo3/sysext/scheduler/locallang.xml (working copy)
<label index="testTask.description">The Scheduler test task just sends a mail to a given email address. It is designed to be used for testing purposes.</label>
<label index="sleepTask.name">Scheduler sleep task</label>
<label index="sleepTask.description">This task does nothing but put PHP to sleep for a number of seconds. It is designed to test multiple executions.</label>
<label index="cachingFrameworkGarbageCollection.name">Caching framework garbage collection</label>
<label index="cachingFrameworkGarbageCollection.description">This task calls the garbage collection of configured caching framework caches using one of the selected backends. This will free some space in cache backends which do not have an internal garbage collection. In case of the default database backend it is advisable to run this task once a day when the database is mostly idle.</label>
</languageKey>
</data>
</T3locallang>
typo3/sysext/scheduler/mod1/locallang_csh_scheduler.xml (working copy)
<label index="task_email.description">Enter a recipient for the mails sent by the test task</label>
<label index="task_sleepTime.alttitle">Sleep time</label>
<label index="task_sleepTime.description">Enter a number of seconds during which the task will just sleep.</label>
<label index="task_cachingFrameworkGarbageCollection_selectedBackends.alttitle">Select backends</label>
<label index="task_cachingFrameworkGarbageCollection_selectedBackends.description">If a cache uses one of the selected backends, the garbage collection will be called for this cache.</label>
</languageKey>
</data>
</T3locallang>
typo3/sysext/scheduler/mod1/locallang.xml (working copy)
<label index="hdg.lastRun">Last run</label>
<label index="hdg.schedulerUser">TYPO3 Scheduler backend user</label>
<label index="label.automatically">automatically</label>
<label index="label.cachingFrameworkGarbageCollection.selectBackends">Backend types</label>
<label index="label.checkAll">Check/uncheck all</label>
<label index="label.class">Class</label>
<label index="label.cron">Cron</label>
typo3/sysext/scheduler/tests/tx_scheduler_cachingframeworkgarbagecollectionTest.php (revision 0)
<?php
/***************************************************************
* Copyright notice
*
* (c) 2010 Christian Kuhn <lolli@schwarzbu.ch>
* All rights reserved
*
* This script is part of the TYPO3 project. The TYPO3 project is
* free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* The GNU General Public License can be found at
* http://www.gnu.org/copyleft/gpl.html.
*
* This script 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 General Public License for more details.
*
* This copyright notice MUST APPEAR in all copies of the script!
***************************************************************/
/**
* Testcase for class "tx_scheduler_CachingFrameworkGarbageCollection"
*
* @package TYPO3
* @subpackage tx_scheduler
*
* @author Christian Kuhn <lolli@schwarzbu.ch>
*/
class tx_scheduler_CachingFrameworkGarbageCollectionTest extends tx_phpunit_testcase {
protected $backupGlobals = TRUE;
/**
* @test
*/
public function executeCallsCollectGarbageOfConfiguredBackend() {
$cache = $this->getMock('t3lib_cache_frontend_StringFrontend', array(), array(), '', FALSE);
$cache->expects($this->any())->method('getIdentifier')->will($this->returnValue('cache'));
$cache->expects($this->atLeastOnce())->method('collectGarbage');
$GLOBALS['typo3CacheManager'] = new t3lib_cache_Manager();
$GLOBALS['typo3CacheManager']->registerCache($cache);
$GLOBALS['TYPO3_CONF_VARS']['SYS']['caching']['cacheConfigurations'] = array(
'cache' => array(
'frontend' => 't3lib_cache_frontend_StringFrontend',
'backend' => 't3lib_cache_backend_AbstractBackend',
),
);
$task = new tx_scheduler_CachingFrameworkGarbageCollection();
$task->selectedBackends = array('t3lib_cache_backend_AbstractBackend');
$task->execute();
}
/**
* @test
*/
public function executeDoesNotCallCollectGarbageOfConfiguredBackend() {
$cache = $this->getMock('t3lib_cache_frontend_StringFrontend', array(), array(), '', FALSE);
$cache->expects($this->any())->method('getIdentifier')->will($this->returnValue('cache'));
$cache->expects($this->never())->method('collectGarbage');
$GLOBALS['typo3CacheManager'] = new t3lib_cache_Manager();
$GLOBALS['typo3CacheManager']->registerCache($cache);
$GLOBALS['TYPO3_CONF_VARS']['SYS']['caching']['cacheConfigurations'] = array(
'cache' => array(
'frontend' => 't3lib_cache_frontend_StringFrontend',
'backend' => 't3lib_cache_backend_AbstractBackend',
),
);
$task = new tx_scheduler_CachingFrameworkGarbageCollection();
$task->selectedBackends = array('t3lib_cache_backend_NullBackend');
$task->execute();
}
}
?>
typo3/sysext/scheduler/ext_localconf.php (working copy)
'additionalFields' => 'tx_scheduler_SleepTask_AdditionalFieldProvider'
);
}
?>
// Add caching framework garbage collection task
$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['scheduler']['tasks']['tx_scheduler_CachingFrameworkGarbageCollection'] = array(
'extension' => $_EXTKEY,
'title' => 'LLL:EXT:' . $_EXTKEY . '/locallang.xml:cachingFrameworkGarbageCollection.name',
'description' => 'LLL:EXT:' . $_EXTKEY . '/locallang.xml:cachingFrameworkGarbageCollection.description',
'additionalFields' => 'tx_scheduler_CachingFrameworkGarbageCollection_AdditionalFieldProvider',
);
?>
typo3/sysext/scheduler/ext_autoload.php (working copy)
*
* $Id$
*/
// TODO: document necessity of providing autoloader information
$extPath = t3lib_extMgm::extPath('scheduler');
return array(
'tx_scheduler' => t3lib_extMgm::extPath('scheduler', 'class.tx_scheduler.php'),
'tx_scheduler_croncmd' => t3lib_extMgm::extPath('scheduler', 'class.tx_scheduler_croncmd.php'),
'tx_scheduler_task' => t3lib_extMgm::extPath('scheduler', 'class.tx_scheduler_task.php'),
'tx_scheduler_execution' => t3lib_extMgm::extPath('scheduler', 'class.tx_scheduler_execution.php'),
'tx_scheduler_failedexecutionexception' => t3lib_extMgm::extPath('scheduler', 'class.tx_scheduler_failedexecutionexception.php'),
'tx_scheduler_testtask' => t3lib_extMgm::extPath('scheduler', 'examples/class.tx_scheduler_testtask.php'),
'tx_scheduler_testtask_additionalfieldprovider' => t3lib_extMgm::extPath('scheduler', 'examples/class.tx_scheduler_testtask_additionalfieldprovider.php'),
'tx_scheduler_sleeptask' => t3lib_extMgm::extPath('scheduler', 'examples/class.tx_scheduler_sleeptask.php'),
'tx_scheduler_sleeptask_additionalfieldprovider' => t3lib_extMgm::extPath('scheduler', 'examples/class.tx_scheduler_sleeptask_additionalfieldprovider.php')
'tx_scheduler' => $extPath . 'class.tx_scheduler.php',
'tx_scheduler_croncmd' => $extPath . 'class.tx_scheduler_croncmd.php',
'tx_scheduler_task' => $extPath . 'class.tx_scheduler_task.php',
'tx_scheduler_execution' => $extPath . 'class.tx_scheduler_execution.php',
'tx_scheduler_failedexecutionexception' => $extPath . 'class.tx_scheduler_failedexecutionexception.php',
'tx_scheduler_testtask' => $extPath . 'examples/class.tx_scheduler_testtask.php',
'tx_scheduler_testtask_additionalfieldprovider' => $extPath . 'examples/class.tx_scheduler_testtask_additionalfieldprovider.php',
'tx_scheduler_sleeptask' => $extPath . 'examples/class.tx_scheduler_sleeptask.php',
'tx_scheduler_sleeptask_additionalfieldprovider' => $extPath . 'examples/class.tx_scheduler_sleeptask_additionalfieldprovider.php',
'tx_scheduler_cachingframeworkgarbagecollection' => $extPath . 'tasks/class.tx_scheduler_cachingframeworkgarbagecollection.php',
'tx_scheduler_cachingframeworkgarbagecollection_additionalfieldprovider' => $extPath . 'tasks/class.tx_scheduler_cachingframeworkgarbagecollection_additionalfieldprovider.php',
);
?>
(1-1/2)