wiki.techinc.nl/includes/cache/ResourceFileCache.php
TChin 47adb6d65a Refactor global variables to use MediaWikiServices instead
Automatically refactors wg prefixed globals to use MediaWikiServices config using Rector. Doesn't include files that set globals or files that fail CI.

Rector Gist: https://gist.github.com/tchin25/7cc54f6d23aedef010b22e4dfbead228

* This patch uses a modified source code rector library for our specific use case and the rector will have different effects without it.

A writeup for future reference is here: https://meta.wikimedia.org/wiki/User:TChin_(WMF)/Using_Rector_On_MediaWiki

Change-Id: I1a691f01cd82e60bf41207d32501edb4b9835e37
2022-01-10 13:55:53 -05:00

123 lines
3.6 KiB
PHP

<?php
/**
* ResourceLoader request result caching in the file system.
*
* This program 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.
*
* 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 General Public License for more details.
*
* You should have received a copy of the GNU General Public License along
* with this program; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
* http://www.gnu.org/copyleft/gpl.html
*
* @file
* @ingroup Cache
*/
use MediaWiki\MediaWikiServices;
/**
* ResourceLoader request result caching in the file system.
*
* @ingroup Cache
*/
class ResourceFileCache extends FileCacheBase {
protected $mCacheWorthy;
/* @todo configurable? */
private const MISS_THRESHOLD = 360; // 6/min * 60 min
/**
* Construct an ResourceFileCache from a context
* @param ResourceLoaderContext $context
* @return ResourceFileCache
*/
public static function newFromContext( ResourceLoaderContext $context ) {
$cache = new self();
if ( $context->getImage() ) {
$cache->mType = 'image';
} elseif ( $context->getOnly() === 'styles' ) {
$cache->mType = 'css';
} else {
$cache->mType = 'js';
}
$modules = array_unique( $context->getModules() ); // remove duplicates
sort( $modules ); // normalize the order (permutation => combination)
$cache->mKey = sha1( $context->getHash() . implode( '|', $modules ) );
if ( count( $modules ) == 1 ) {
$cache->mCacheWorthy = true; // won't take up much space
}
return $cache;
}
/**
* Check if an RL request can be cached.
* Caller is responsible for checking if any modules are private.
* @param ResourceLoaderContext $context
* @return bool
*/
public static function useFileCache( ResourceLoaderContext $context ) {
$mainConfig = MediaWikiServices::getInstance()->getMainConfig();
$useFileCache = $mainConfig->get( 'UseFileCache' );
$defaultSkin = $mainConfig->get( 'DefaultSkin' );
$languageCode = $mainConfig->get( 'LanguageCode' );
if ( !$useFileCache ) {
return false;
}
// Get all query values
$queryVals = $context->getRequest()->getValues();
foreach ( $queryVals as $query => $val ) {
if ( in_array( $query, [ 'modules', 'image', 'variant', 'version' ] ) ) {
// Use file cache regardless of the value of this parameter
continue;
} elseif ( $query === 'skin' && $val === $defaultSkin ) {
continue;
} elseif ( $query === 'lang' && $val === $languageCode ) {
continue;
} elseif ( $query === 'only' && in_array( $val, [ 'styles', 'scripts' ] ) ) {
continue;
} elseif ( $query === 'debug' && $val === 'false' ) {
continue;
} elseif ( $query === 'format' && $val === 'rasterized' ) {
continue;
}
return false;
}
return true; // cacheable
}
/**
* Get the base file cache directory
* @return string
*/
protected function cacheDirectory() {
return $this->baseCacheDirectory() . '/resources';
}
/**
* Item has many recent cache misses
* @return bool
*/
public function isCacheWorthy() {
if ( $this->mCacheWorthy === null ) {
$this->mCacheWorthy = (
$this->isCached() || // even stale cache indicates it was cache worthy
$this->getMissesRecent() >= self::MISS_THRESHOLD // many misses
);
}
return $this->mCacheWorthy;
}
}