X-Git-Url: https://git.heureux-cyclage.org/?a=blobdiff_plain;f=includes%2FDefaultSettings.php;h=9bff00480982d34d607cb30c4d8b3abf3a7772a7;hb=3f0056a252daa4e97396e0eb4b72651f33ce57b3;hp=7112468115540e44973203ba376313778f2f9ae4;hpb=3c9f343ecbe3295490918ccd75820c41ea4da314;p=lhc%2Fweb%2Fwiklou.git diff --git a/includes/DefaultSettings.php b/includes/DefaultSettings.php index 7112468115..9bff004809 100644 --- a/includes/DefaultSettings.php +++ b/includes/DefaultSettings.php @@ -193,6 +193,13 @@ $wgScript = false; */ $wgLoadScript = false; +/** + * The URL path to the REST API + * Defaults to "{$wgScriptPath}/rest.php" + * @since 1.34 + */ +$wgRestPath = false; + /** * The URL path of the skins directory. * Defaults to "{$wgResourceBasePath}/skins". @@ -508,7 +515,7 @@ $wgImgAuthUrlPathMap = []; * equivalent to the corresponding member of $wgDBservers * - tablePrefix Table prefix, the foreign wiki's $wgDBprefix * - hasSharedCache Set to true if the foreign wiki's $wgMainCacheType is identical to, - * and accesible from, this wiki. + * and accessible from, this wiki. * * ForeignAPIRepo: * - apibase Use for the foreign API's URL @@ -554,7 +561,7 @@ $wgUseInstantCommons = false; /** * Shortcut for adding an entry to $wgForeignFileRepos. * - * Uses the folowing variables: + * Uses the following variables: * * - directory: $wgSharedUploadDirectory. * - url: $wgSharedUploadPath. @@ -2563,26 +2570,35 @@ $wgUseLocalMessageCache = false; $wgAdaptiveMessageCache = false; /** - * Localisation cache configuration. Associative array with keys: - * class: The class to use. May be overridden by extensions. + * Localisation cache configuration. + * + * Used by Language::getLocalisationCache() to decide how to construct the + * LocalisationCache instance. Associative array with keys: * - * 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. + * 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. * - * storeClass: The class name for the underlying storage. If set to a class - * name, it overrides the "store" setting. + * storeClass: Which LCStore class implementation to use. This is optional. + * The default LocalisationCache class offers the 'store' option + * as abstraction for this. * - * 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. + * 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. * - * manualRecache: Set this to true to disable cache updates on web requests. - * Use maintenance/rebuildLocalisationCache.php instead. + * 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, @@ -2692,7 +2708,8 @@ $wgExtensionInfoMTime = false; * @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 @@ -2704,8 +2721,10 @@ $wgExtensionInfoMTime = false; /** * 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): @@ -2747,12 +2766,15 @@ $wgInternalServer = 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; @@ -2767,7 +2789,7 @@ $wgCdnMaxageLagged = 30; * If a purge for a URL reaches cdn2 before cdn1 and a request reaches cdn2 for that URL, * it will populate the response from the stale cdn1 value. When cdn1 gets the purge, cdn2 * will still be stale. If the rebound purge delay is safely higher than the time to relay - * a purge to all nodes, then the rebound puge will clear cdn2 after cdn1 was cleared. + * a purge to all nodes, then the rebound purge will clear cdn2 after cdn1 was cleared. * * @since 1.27 */ @@ -2775,7 +2797,7 @@ $wgCdnReboundPurgeDelay = 0; /** * 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; @@ -2794,20 +2816,24 @@ $wgForcedRawSMaxage = 300; * 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 @@ -3350,7 +3376,7 @@ $wgAllowUserCss = false; * Allow style-related user-preferences? * * This controls whether the `editfont` and `underline` preferences - * are availabe to users. + * are available to users. */ $wgAllowUserCssPrefs = true; @@ -3488,7 +3514,7 @@ $wgFooterIcons = [ // "$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", ] ], @@ -5701,6 +5727,10 @@ $wgRateLimits = [ 'newbie' => [ 5, 86400 ], 'user' => [ 20, 86400 ], ], + 'changeemail' => [ + 'ip-all' => [ 10, 3600 ], + 'user' => [ 4, 86400 ] + ], // Purging pages 'purge' => [ 'ip' => [ 30, 60 ], @@ -6496,7 +6526,7 @@ $wgCachePrefix = false; /** * 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 */ @@ -8058,10 +8088,10 @@ $wgExemptFromUserRobotsControl = null; /** @} */ # End robot policy } /************************************************************************//** - * @name AJAX and API + * @name AJAX, Action API and REST API * Note: The AJAX entry point which this section refers to is gradually being - * replaced by the API entry point, api.php. They are essentially equivalent. - * Both of them are used for dynamic client-side features, via XHR. + * replaced by the Action API entry point, api.php. They are essentially + * equivalent. Both of them are used for dynamic client-side features, via XHR. * @{ */ @@ -8421,6 +8451,13 @@ $wgLocalVirtualHosts = []; */ $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 } /************************************************************************//** @@ -8481,6 +8518,7 @@ $wgExternalDiffEngine = false; * See $wgExternalDiffEngine. * * @since 1.30 + * @deprecated since 1.34 */ $wgWikiDiff2MovedParagraphDetectionCutoff = 0; @@ -8835,7 +8873,7 @@ $wgRawHtmlMessages = [ * that uses it, MediaWiki can broadcast events to all subscribers. Certain features like WAN * cache purging and CDN cache purging will emit events to this system. Appropriate listers can * subscribe to the channel and take actions based on the events. For example, a local daemon - * can run on each CDN cache node and perfom local purges based on the URL purge channel events. + * can run on each CDN cache node and perform local purges based on the URL purge channel events. * * Some extensions may want to use "channel categories" so that different channels can also share * the same custom relayer instance (e.g. when it's likely to be overriden). They can use @@ -9066,6 +9104,17 @@ $wgReportToEndpoints = []; */ $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