Manual talk:Configuration settings

Please do not post support questions here.

Instead, use one of these channels:

• Project:Support desk
• the mailing list

Further options for contacting appropriate people can be found at Communication .

Some archived discussion from when the page was located on meta can be found in /archive from meta (including full page history).

Let's kill the insane contents of this page!

I don't understand what value this page adds.

• Category:MediaWiki configuration settings#mw-pages and other categories automatically list every variable.
• The generated documentation DefaultSettings.php.php should be the canonical source of the config variable descriptions.

  (BTW, I'm not sure why Modules > Global settings in the generated doc is empty.)

So, why are we manually maintaining yet another way to get lost in 900+ configuration variables?

Note that MediaWiki is moving away from$wgSomeName globals (phab:T11968):

• Extensions specify SomeName settings in extension.json that update configuration variables (see Manual:Extension registration).
• Code should query context->config->get( 'Somename ) (see Manual:Configuration for developers).
• That leaves just LocalSettings.php still screwing with $wg variables.

I'll be returning to this issue as part of a future reorganizing and deprecating $wg. I'd be happy if someone else is brave and kills 1000 lines of this before me :-)

-- SPage (WMF) (talk) 22:59, 22 September 2015 (UTC)

I use this page on a daily basis as part of providing support to Project:Support desk or IRC, whenever I have to check a variable name that I don't know if I'm spelling it right or I don't remember exactly the name. Categories are hard to navigate, while having all variables on one page and a small description is very valuable when performing searches on the page from the browser itself. --Ciencia Al Poder (talk) 09:42, 23 September 2015 (UTC)

While MW is moving away, it hasn't moved, so the documentation is still required.

The category listing(s), although listy, offer little to no information; they're just lists of links which all require following to be of any value.

Having a tidy single online source of basic info about related variables makes life easy for folk looking for info IMO.

What harm does it do to maintain this documentation while it's still relevant? I'd be the first to suggest killing archiving it when it's redundant. fredgandt 09:45, 7 March 2016 (UTC)

Undocumented globals

I went through a quick check through the default settings by looking for @since MW version marks while comparing through the existing categories, these were the ones that came up to the list. I was going to originally make a personal todo subpage, but I figured it'd be more discoverable if it's on here. This list is probably incomplete, but I'll keep looking. Feel free to create any of these pages if you want to :)

Introduced in 1.20

• $wgSiteTypes

Introduced in 1.22

• $wgExtensionEntryPointListFiles
• $wgResourceLoaderLESSVars

Introduced in 1.23

• $wgSharedSchema
• $wgResourceLoaderStorageVersion

Introduced in 1.24

• $wgFallbackSkin

Introduced in 1.25

• $wgStatsdServer
• $wgStatsdMetricPrefix
• $wgLocalVirtualHosts
• $wgUploadThumbnailRenderHttpCustomDomain
• $wgUploadThumbnailRenderHttpCustomHost
• $wgUploadThumbnailRenderMap
• $wgUploadThumbnailRenderMethod
• $wgExtensionInfoMTime

Introduced in 1.26

• $wgExiftool
• $wgTrxProfilerLimits
• $wgJobSerialCommitThreshold

Introduced in 1.27

• $wgMaxInterlacingAreas
• $wgDataCenterUpdateStickTTL
• $wgCdnMaxageLagged
• $wgCdnMaxageSubstitute
• $wgExportPagelistLimit
• $wgSessionSecret
• $wgPopularPasswordFile
• $wgEventRelayerConfig

Introduced in 1.28

• $wgStatsdSamplingRates

Unknown

I should note that the ones that are listed under this section are because they didn't have a @since mark and I wasn't able to quickly find a commit that introduced them (will continue digging)

• $wgOpenSearchDescriptionLength
• $wgSearchTypeAlternatives
• $wgLangObjCacheSize
• $wgEnableAsyncUploads
• $wgDBOracleDRCP
• $wgAPIUselessQueryPages

SamanthaNguyen (talk) 20:16, 5 August 2017 (UTC)

To be added

• Manual:$wgEnableAsyncUploads
• Manual:$wgImgAuthUrlPathMap
• Manual:$wgPageLanguageUseDB
• Manual:$wgUnwatchedPageThreshold
• Manual:$wgEnableMagicLinks
• Manual:$wgCopyUploadsFromSpecialUpload

Casca Dinger (talk) 00:46, 16 October 2018 (UTC)

Renaming of configuration settings related to Squid to more generic names

Now that Rename CDN config variables to be generic, deprecating the old names has been merged, the configuration settings named Squid have been removed (or deprecated). However, this page still lists those (and other related settings) under the header Squid. As MediaWiki supports more than just Squid (with WMF using Varnish, for example), these settings should be moved to a new section. There is already a section caching. Should we move those there? —Mainframe98 _talk 12:09, 25 May 2019 (UTC)

Cache is too generic. Maybe CDN? That's how they're grouped in DefaultSettings. --Ciencia Al Poder (talk) 09

17, 27 May 2019 (UTC)