$wgAdaptiveMessageCache = false;
/**
- * Localisation cache configuration. Associative array with keys:
- * class: The class to use. May be overridden by extensions.
+ * Localisation cache configuration.
*
- * store: The location to store cache data. May be 'files', 'array', 'db' or
- * 'detect'. If set to "files", data will be in CDB files. If set
- * to "db", data will be stored to the database. If set to
- * "detect", files will be used if $wgCacheDirectory is set,
- * otherwise the database will be used.
- * "array" is an experimental option that uses PHP files that
- * store static arrays.
+ * Used by Language::getLocalisationCache() to decide how to construct the
+ * LocalisationCache instance. Associative array with keys:
*
- * storeClass: The class name for the underlying storage. If set to a class
- * name, it overrides the "store" setting.
+ * class: The class to use for constructing the LocalisationCache object.
+ * This may be overridden by extensions to a subclass of LocalisationCache.
+ * Sub classes are expected to still honor the 'storeClass', 'storeDirectory'
+ * and 'manualRecache' options where applicable.
*
- * storeDirectory: If the store class puts its data in files, this is the
- * directory it will use. If this is false, $wgCacheDirectory
- * will be used.
+ * storeClass: Which LCStore class implementation to use. This is optional.
+ * The default LocalisationCache class offers the 'store' option
+ * as abstraction for this.
*
- * manualRecache: Set this to true to disable cache updates on web requests.
- * Use maintenance/rebuildLocalisationCache.php instead.
+ * store: How and where to store localisation cache data.
+ * This option is ignored if 'storeClass' is explicitly set to a class name.
+ * Must be one of:
+ * - 'detect' (default): Automatically select 'files' if 'storeDirectory'
+ * or $wgCacheDirectory is set, and fall back to 'db' otherwise.
+ * - 'files': Store in $wgCacheDirectory as CDB files.
+ * - 'array': Store in $wgCacheDirectory as PHP static array files.
+ * - 'db': Store in the l10n_cache database table.
+ *
+ * storeDirectory: If the selected LCStore class puts its data in files, then it
+ * will use this directory. If set to false (default), then
+ * $wgCacheDirectory is used instead.
+ *
+ * manualRecache: Set this to true to disable cache updates on web requests.
+ * Use maintenance/rebuildLocalisationCache.php instead.
*/
$wgLocalisationCacheConf = [
'class' => LocalisationCache::class,
* @name HTTP proxy (CDN) settings
*
* Many of these settings apply to any HTTP proxy used in front of MediaWiki,
- * although they are referred to as Squid settings for historical reasons.
+ * although they are sometimes still referred to as Squid settings for
+ * historical reasons.
*
* Achieving a high hit ratio with an HTTP proxy requires special
* configuration. See https://www.mediawiki.org/wiki/Manual:Squid_caching for
/**
* Enable/disable CDN.
* See https://www.mediawiki.org/wiki/Manual:Squid_caching
+ *
+ * @since 1.34 Renamed from $wgUseSquid.
*/
-$wgUseSquid = false;
+$wgUseCdn = false;
/**
* If you run Squid3 with ESI support, enable this (default:false):
* out s-maxage in the CDN config.
*
* 18000 seconds = 5 hours, more cache hits with 2678400 = 31 days.
+ *
+ * @since 1.34 Renamed from $wgSquidMaxage
*/
-$wgSquidMaxage = 18000;
+$wgCdnMaxAge = 18000;
/**
* Cache timeout for the CDN when DB replica DB lag is high
- * @see $wgSquidMaxage
+ * @see $wgCdnMaxAge
+ *
* @since 1.27
*/
$wgCdnMaxageLagged = 30;
/**
* Cache timeout for the CDN when a response is known to be wrong or incomplete (due to load)
- * @see $wgSquidMaxage
+ * @see $wgCdnMaxAge
* @since 1.27
*/
$wgCdnMaxageSubstitute = 60;
* headers sent/modified from these proxies when obtaining the remote IP address
*
* For a list of trusted servers which *aren't* purged, see $wgSquidServersNoPurge.
+ *
+ * @since 1.34 Renamed from $wgSquidServers.
*/
-$wgSquidServers = [];
+$wgCdnServers = [];
/**
- * As above, except these servers aren't purged on page changes; use to set a
- * list of trusted proxies, etc. Supports both individual IP addresses and
- * CIDR blocks.
+ * As with $wgCdnServers, except these servers aren't purged on page changes;
+ * use to set a list of trusted proxies, etc. Supports both individual IP
+ * addresses and CIDR blocks.
+ *
* @since 1.23 Supports CIDR ranges
+ * @since 1.34 Renamed from $wgSquidServersNoPurge
*/
-$wgSquidServersNoPurge = [];
+$wgCdnServersNoPurge = [];
/**
* Whether to use a Host header in purge requests sent to the proxy servers
- * configured in $wgSquidServers. Set this to false to support Squid
+ * configured in $wgCdnServers. Set this to false to support a CDN
* configured in forward-proxy mode.
*
* If this is set to true, a Host header will be sent, and only the path
// "$wgResourceBasePath/resources/assets/poweredby_mediawiki_88x31.png"
// plus srcset for 1.5x, 2x resolution variants.
"src" => null,
- "url" => "//www.mediawiki.org/",
+ "url" => "https://www.mediawiki.org/",
"alt" => "Powered by MediaWiki",
]
],
'previewonfirst' => 0,
'previewontop' => 1,
'rcdays' => 7,
- 'rcenhancedfilters' => 0,
'rcenhancedfilters-disable' => 0,
'rclimit' => 50,
'rows' => 25, // @deprecated since 1.29 No longer used in core
/**
* Display the new debugging toolbar. This also enables profiling on database
* queries and other useful output.
- * Will be ignored if $wgUseFileCache or $wgUseSquid is enabled.
+ * Will be ignored if $wgUseFileCache or $wgUseCdn is enabled.
*
* @since 1.19
*/
*/
$wgHTTPConnectTimeout = 5e0;
+/**
+ * Whether to respect/honour the request ID provided by the incoming request
+ * via the `X-Request-Id` header. Set to `true` if the entity sitting in front
+ * of Mediawiki sanitises external requests. Default: `false`.
+ */
+$wgAllowExternalReqID = false;
+
/** @} */ # End HTTP client }
/************************************************************************//**
* See $wgExternalDiffEngine.
*
* @since 1.30
+ * @deprecated since 1.34
*/
$wgWikiDiff2MovedParagraphDetectionCutoff = 0;
*/
$wgFeaturePolicyReportOnly = [];
+/**
+ * Options for Special:Search completion widget form created by SearchFormWidget class.
+ * Settings that can be used:
+ * - showDescriptions: true/false - whether to show opensearch description results
+ * - performSearchOnClick: true/false - whether to perform search on click
+ * See also TitleWidget.js UI widget.
+ * @since 1.34
+ * @var array
+ */
+$wgSpecialSearchFormOptions = [];
+
/**
* For really cool vim folding this needs to be at the end:
* vim: foldmarker=@{,@} foldmethod=marker