Manual:$wgResourceLoaderMaxage
Appearance
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 |
Other settings: Alphabetical | By function |
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
- ResourceLoader
$wgResourceModules
- Register modules that can later be loaded on a page$wgResourceModuleSkinStyles
- Register skin-provided stylesheets to add to an existing ResourceLoader module$wgResourceLoaderDebug
- Configure the default debug mode for MediaWiki.- Internal configuration settings:
$wgExtensionAssetsPath
,$wgResourceLoaderMaxage
- ResourceLoaderRegisterModules hook
- Developing with ResourceLoader – Learn how to use ResourceLoader in MediaWiki