Jump to content

Manual:$wgResourceLoaderMaxage

From mediawiki.org
ResourceLoader: $wgResourceLoaderMaxage
How long a CDN or browser may cache a ResourceLoader HTTP response.
Introduced in version:1.17.0 (r73568)
Removed in version:Still in use
Allowed values:(array)
Default value:see below

Details

[edit]

How long a CDN or browser may cache a ResourceLoader HTTP response. Maximum time in seconds. Used for the 'max-age' and 's-maxage' Cache-Control headers.

Default value

[edit]
MediaWiki version:
1.39
Gerrit change 776355

The default value has since been moved to the constructor of ResourceLoader in ResourceLoader.php .

$wgResourceLoaderMaxage = [];
MediaWiki versions:
1.35 – 1.38
$wgResourceLoaderMaxage = [
	'versioned' => 30 * 24 * 60 * 60, // 30 days
	'unversioned' => 5 * 60 // 5 minutes
];
MediaWiki versions:
1.17 – 1.34
$wgResourceLoaderMaxage = array(
	'versioned' => array(
		// Squid/Varnish but also any other public proxy cache between the client and MediaWiki
		'server' => 30 * 24 * 60 * 60, // 30 days
		// On the client side (e.g. in the browser cache).
		'client' => 30 * 24 * 60 * 60, // 30 days
	),
	'unversioned' => array(
		'server' => 5 * 60, // 5 minutes
		'client' => 5 * 60, // 5 minutes
	),
);
This syntax is not compatible anymore. This happened after this change: phab:T235314

To simplify troubleshooting, here is a known exception related to this old syntax:

/load.php?lang=it&modules=skins.vector.styles.legacy,responsive&only=styles&skin=vector   Error from line 1073 of includes/resourceloader/ResourceLoader.php: Unsupported operand types
#0 includes/resourceloader/ResourceLoader.php(891): ResourceLoader->tryRespondFromFileCache(ResourceFileCache, ResourceLoaderContext, string)
#1 load.php(51): ResourceLoader->respond(ResourceLoaderContext)
#2 load.php(38): wfLoadMain()
#3 {main}

To fix this issue just migrate to the new syntax without the "server" and "client" distinction.

See also