手册:配置设置

This is an index of all supported configuration settings based on the DefaultSettings.php file.

Never edit DefaultSettings.php; copy appropriate lines to LocalSettings.php instead and amend them as appropriate.

If you can't find a configuration setting here, see if it is defined in DefaultSettings.php. The variable should have some documentation there.

Settings removed in versions of MediaWiki prior to 1.19 are no longer listed here. Please use the search box to find the relevant manual page (e.g. Manual:$wgAllowAnonymousMinor).

按字母排序列表 | 按功能排序列表 | Category:MediaWiki configuration settings

一般设置

• $wgCanonicalServer - Canonical URL of the server, to use in IRC feeds, notification e-mails, etc.
• $wgServer - The base URL of the server.
• $wgServerName - The name of the server without the protocol.
• $wgSitename - The name of the site.
• $wgVersion - MediaWiki version number. You should not change this!

路径

• $IP - The full path to the installation directory.
• $wgActionPaths - Paths for various user actions. Used to make URLs prettier.
• $wgAppleTouchIcon - Optional URL to an icon to use when bookmarking to the home screen on Apple handheld devices
• $wgArticlePath - The base URL used to create article links.
• $wgConfigRegistry - Registry of factory functions to create config objects
• $wgDiff - Path to the GNU diff utility.
• $wgDiff3 - Path to the GNU diff3 utility.
• $wgDirectoryMode - Default chmod permission value for newly created directories.
• $wgFavicon - The URL of the site favicon.
• $wgGitBin - Path to the git binary.
• $wgGitInfoCacheDirectory - Directory where GitInfo will look for pre-computed cache files.
• $wgLoadScript - The URL path to load.php.
• $wgLogo - The URL of the site logo.
• $wgLogoHD - URLs for HD versions of the site logo.
• $wgPhpCli - Executable name of PHP cli client (php/php5).
• $wgRedirectScript - (removed in 1.22) The URL of redirect.php.
• $wgScript - The URL of index.php.
• $wgScriptExtension - (removed in 1.27) Extension to append to script names by default.
• $wgScriptPath - The base URL path.
• $wgStyleSheetPath - Do not set $wgStyleSheetPath. Use $wgStylePath instead.
• $wgTmpDirectory - The path of the temporary directory.
• $wgUsePathInfo - Whether to use 'pretty' URLs.
• $wgVariantArticlePath - Used for links when having language's variants.

See also Uploads for file/image upload path settings.

See also Skins for skins path settings.

Global Objects

• $wgAutoloadLocalClasses - Array mapping class names to filenames, for autoloading.
• $wgConf - Create a site configuration object. Not used for much in a default install.
• $wgVirtualRestConfig - REST services configuration.

Email settings

See also User Access: $wgEmailConfirmToEdit

• $wgAdditionalMailParams - Additional email parameters, will be passed as the last argument to mail() PHP function call.
• $wgAllowHTMLEmail - Set to true to enable HTML emails.
• $wgEmailAuthentication - Set to true to enable email authentication (confirmation) for this wiki. Except for password reminder emails, email functions only work for authenticated email addresses.
• $wgEmergencyContact - Site admin email address
• $wgEnableEmail - Set to true to enable basic email features.
• $wgEnableUserEmail - Set to true to enable user-to-user email.
• $wgNoReplyAddress - Reply-to address for automatically generated emails.
• $wgPasswordReminderResendTime - Minimum time, in hours, which must elapse between password reminder emails.
• $wgPasswordSender - Password reminder email address.
• $wgPasswordSenderName - (removed in 1.23) Password reminder ($wgPasswordSenderManual:$wgPasswordSender) name.
• $wgRequirePasswordforEmailChange - (removed in 1.27) Whether the user must enter their password to change their email address
• $wgSMTP - For using a direct (authenticated) SMTP server connection.
• $wgSysopEmailBans - Allow sysops to ban users from accessing Special:Emailuser.
• $wgUserEmailConfirmationTokenExpiry - The time, in seconds, after which an email address confirmation token expires.
• $wgUserEmailUseReplyTo - Set to true to put the sending user's email in a Reply-To header instead of From.

Email notification (Enotif) settings

Actual notifications for each user are defined in the options. You can change defaults with $wgDefaultUserOptions.

• $wgEnotifFromEditor - Whether to make email notifications appear to come from the user who makes the edit
• $wgEnotifImpersonal - Send a generic mail instead of a personalised mail for each user.
• $wgEnotifMaxRecips - Maximum number of users to mail at once when using impersonal mail.
• $wgEnotifMinorEdits - Set to true to allow sending email notification also for edits marked as minor edits
• $wgEnotifRevealEditorAddress - Set to true to insert the page editor's email address into the email notifications Reply-To address
• $wgEnotifUseJobQ - Send mails via the job queueManual:Job queue.
• $wgEnotifUseRealName - Use real name instead of username in email "from" field.
• $wgEnotifUserTalk - Set to true to allow the email notification for the own user_talk page
• $wgEnotifWatchlist - Set to true to allow the email notification for watched pages
• $wgUseEnotif - Overall "use Enotif" setting
• $wgUsersNotifiedOnAllChanges - Array of usernames who will be sent a notification email for every change which occurs on a wiki.

Database settings

• $wgAllDBsAreLocalhost - Make all database connections secretly go to localhost.
• $wgContentHandlerUseDB (removed in 1.28) - Whether to use the database fields introduced by the ContentHandler facility
• $wgDBAvgStatusPoll (removed in 1.26) - Average time between SHOW STATUS queries in overload conditions.
• $wgDBcompress - Whether to use compression in DB connection.
• $wgDBerrorLog - File to log database errors to.
• $wgDBname - Name of the database.
• $wgDBpassword - The password for $wgDBuser.
• $wgDBport - Database port. Only used by PostgreSQL and MSSQL.
• $wgDBprefix - Table name prefix.
• $wgDBserver - Host name or IP address of database server.
• $wgDBssl - Whether to use SSL in DB connection.
• $wgDBtype - Type of database.
• $wgDBuser - Database username.
• $wgLocalDatabases - Other wikis on this site, can be administered from a single developer account.
• $wgMaxUserDBWriteDuration - Maximum time a user-generated transaction can spend in writes.
• $wgOldChangeTagsIndex - (removed in 1.22) Use old names for change_tags indices.
• $wgSearchType - Type of search used for the wiki.
• $wgSQLMode - SQL mode

LoadBalancer settings

• $wgDBClusterTimeout - (removed in 1.24) Database timeout.
• $wgDBservers - Settings for the database load balancer (database servers and load ratios).
• $wgDefaultExternalStore - Default external store for new revisions.
• $wgLBFactoryConf - Load balancer factory configuration.
• $wgMasterWaitTimeout - (deprecated in 1.24) How long to wait for a slave to catch up to the master.
• $wgSlaveLagCritical - If lag is higher than this value, show a more obvious warning than $wgSlaveLagWarningManual:$wgSlaveLagWarning.
• $wgSlaveLagWarning - If lag is higher than this value, show a warning in some special pages (like watchlist).

MSSQL-specific

• $wgDBWindowsAuthentication - Whether to use Integrated Windows Authentication rather than the standard $wgDBuserManual:$wgDBuser/$wgDBpasswordManual:$wgDBpassword combo.

MySQL-specific

• $wgDBmysql5 - Set to true to set MySQL connection into UTF-8 encoding (experimental)
• $wgDBTableOptions - MySQL table options to use during installation or update.
• $wgDBtransactions - (removed in 1.20) Set to true if using InnoDB tables.
• $wgExternalServers - An array of external MySQL servers.

Oracle-specific

• $wgDBOracleDRCP - Enables persistent connection with DRCP on Oracle.

PostgreSQL-specific

• $wgDBmwschema - Schema that Postgres stores the MediaWiki tables in.

SQLite-specific

• $wgSQLiteDataDir - To override default SQLite data directory.

Shared DB settings

• $wgSharedDB - The name of the shared database.
• $wgSharedPrefix - Prefix to use for the shared database.
• $wgSharedTables - Tables to use in shared database.
• $wgSharedSchema - The table schema for the shared database.

Compressed Storage Support

• $wgCompressRevisions - If this is set on, all future revisions will be compressed on page save, but only if zlib support is available and enabled in PHP.
• $wgDisableOutputCompression - Disable output compression (compression is enabled by default if zlib is available).

Localization

• $wgBetterDirectionality (removed in 1.23) - Experimental better directionality supportdirectionality support.
• $wgDisabledVariants - Disabled variants for language variant conversion.
• $wgDisableLangConversion - Whether to enable language variant conversion.
• $wgDisableTitleConversion - Whether to enable language variant conversion for links.
• $wgDummyLanguageCodes (deprecated in 1.29) - List of language codes that don't correspond to an actual language.
• $wgEditEncoding (removed in 1.28) - Characters not explicitly converted by output encoding
• $wgForceUIMsgAsContentMsg - Array of UI messages that should be treated as content messages
• $wgInterwikiMagic - Treat language links as magic connectors, not inline links.
• $wgLanguageCode - Site language code. Should be one of the ./languages/messages/Messages(.*).php files.
• $wgLegacyEncoding - Set this to eg 'ISO-8859-1' to perform character set conversion when loading old revisions not marked with utf-8 flag.
• $wgLoginLanguageSelector - Show a bar of language selection links in the user login and user registration forms.
• $wgMsgCacheExpiry - When a message in cache expires (in seconds).
• $wgUseDatabaseMessages - Translation using MediaWiki: namespace.
• $wgUseDynamicDates (removed in 1.21) - Enable to allow rewriting dates in page text. DOES NOT FORMAT CORRECTLY FOR MOST LANGUAGES.
• $wgExtraLanguageCodes - List of mappings from one language code to another, to override built-in mappings

Timezone settings

• $wgLocaltimezone - Fake out the timezone that the server thinks it's in.
• $wgLocalTZoffset - Add a distance to the timezone of the server.
• $wgDBerrorLogTZ - Timezone to use in the error log.

Language-specific

English

• $wgAmericanDates - Enable for English module to print dates as eg 'May 12' instead of '12 May'.

Arabic/Hindi

• $wgTranslateNumerals - For Hindi and Arabic use local numerals instead of Western style (0-9) numerals in interface.

Debug/logging

See also: Manual:How to debug

• $wgAggregateStatsID - Allows statistics to be aggregated over more than one wiki when using udp logging.
• $wgDebugAPI - Enable API debugging by removing some restrictions like POST-only
• $wgDebugComments - Include portions of log output in page HTML comment.
• $wgDebugDBTransactions (removed in 1.27) - Trace lifecycle of the database transaction (opening, commit, rollback)
• $wgDebugDumpSql - Dump SQL queries to debug output
• $wgDebugDumpSqlLength (removed in 1.27) - Length limit for dumping queries
• $wgDebugLogFile - The file name of the debug log, or empty if disabled. wfDebug() appends to this file.
• $wgDebugLogGroups - Selective debug logs on a group basis.
• $wgDebugLogPrefix - Prefix for debug log lines
• $wgDebugPrintHttpHeaders - Print HTTP headers for every request in the debug information.
• $wgDebugRawPage - Avoid overlapping debug entries by leaving out CSS.
• $wgDebugRedirects - Displays redirect location instead of actually redirecting to the target URL
• $wgDebugTimestamps - Prefix debug messages with relative timestamp.
• $wgDebugToolbar - Display the debugging toolbar.
• $wgDeprecationReleaseLimit - Release limitation to wfDeprecated warnings.
• $wgDevelopmentWarnings - Whether to throw PHP notices for some possible error conditions and for deprecated functions.
• $wgLogExceptionBacktrace - Whether to send the exception backtrace to the error log.
• $wgMWLoggerDefaultSpi - Default service provider for creating MWLogger instances.
• $wgResourceLoaderDebug - See also ResourceLoader/Features#Debug modeResourceLoader/Features#Debug mode for more about what debug does.
• $wgOverrideHostname - Override server hostname detection with a hardcoded value.
• $wgShowDBErrorBacktrace - If true, show a backtrace for database errors.
• $wgShowDebug - Display debug data at the bottom of the main content area.
• $wgShowSQLErrors - Whether to show "We're sorry, but there has been a database error." pages.
• $wgShowExceptionDetails - If set to true, uncaught exceptions will print a complete stack trace to output.
• $wgStatsMethod (removed in 1.27) - Destination for wfIncrStats() data.

Profiling

• $wgDebugFunctionEntry (removed in 1.25) - Output debug message on every wfProfileIn/wfProfileOut
• $wgDebugProfiling (removed in 1.23) - Detects non-matching wfProfileIn/wfProfileOut calls
• $wgProfiler -
• $wgProfileCallTree (removed in 1.27) - If true, print a raw call tree instead of per-function report
• $wgProfileLimit (deprecated in 1.25) - Only record profiling info for pages that took longer than this
• $wgProfileOnly (deprecated in 1.23) - Don't put non-profiling info into log file
• $wgProfilePerHost (removed in 1.27) - Should application server host be put into profiling table?
• $wgProfileToDatabase (removed in 1.23) - Log sums from profiling into profiling table in db.
• $wgUDPProfilerHost (removed in 1.27) - Host for UDP profiler.
• $wgUDPProfilerPort (removed in 1.27) - Port for UDP profiler.

Site customization

• $wgBreakFrames - Break out of framesets. This can be used to prevent external sites from framing your site.
• $wgCanonicalLanguageLinks (removed in 1.24) - Whether to enable canonical language links in meta data.
• $wgCapitalLinks - Set this to false to avoid forcing the first letter of links to capitals.
• $wgCapitalLinkOverrides - Per namespace configuration for $wgCapitalLinksManual:$wgCapitalLinks
• $wgDefaultLanguageVariant - Default variant code, if false, the default will be the language code.
• $wgEditPageFrameOptions - Control framing of wiki pages globally.
• $wgEnableNewpagesUserFilter (removed in 1.24) - Enable user search in Special:Newpages.
• $wgExtraLanguageNames - List of language names or overrides for default names in Names.php.
• $wgExtraRandompageSQL (removed in 1.19) - Filter for Special:Randompage. Part of a WHERE clause.
• $wgExtraSubtitle (removed in 1.24) - The subtitle to appear under every title.
• $wgHideInterlanguageLinks - Hide interlanguage links from the sidebar.
• $wgIllegalFileChars - Override the default list of illegal characters in file names.
• $wgLegalTitleChars - Override default list of illegal characters in page titles.
• $wgMaxArticleSize - Maximum article size in kilobytes.
• $wgMaxRedirectLinksRetrieved - Maximum number of links to a redirect page listed on Special:Whatlinkshere/RedirectDestination.
• $wgMaxRedirects - Max number of redirects to follow when resolving redirects.
• $wgNoFollowDomainExceptions - External links to these domain names (or any subdomains) will not be set to rel="nofollow"
• $wgNoFollowLinks - If true, external URL links in wiki text will be given the rel="nofollow" attribute.
• $wgPageShowWatchingUsers (removed in 1.25) - Show watching users in Page views.
• $wgRestrictionLevels - Set of permission keys that can be selected on the 'page protection' page.
• $wgSiteNotice - A message to be displayed at the top of every page.
• $wgSiteSupportPage - A page where your users can donate.
• $wgStyleVersion - Appended in the query string of static CSS and JS to clear client side cache when changing this.
• $wgSiteTypes - Register handlers for specific types of sites.
• $wgUniversalEditButton - Enable the UniversalEditButton for browsers that support it
• $wgUrlProtocols - Defines the protocols which are supported and translated in HTML by the MediaWiki parser.
• $wgUseExternalEditor (removed in 1.22) - Activate external editor interface for files and pages.

Ajax

• $wgAjaxExportList (deprecated in 1.27) - List of functions in AjaxFunctions.php that are callable via 手册:index.php的参数Manual:Parameters to index.php
• $wgAjaxUploadDestCheck - Enable AJAX check for file overwrite, pre-upload.
• $wgAjaxWatch (removed in 1.27) - Enable watching/unwatching pages using AJAX.
• $wgUseAjax - Enable use of AJAX features

Frontend

• $wgAllowSiteCSSOnRestrictedPages - Allow site-wide CSS on restricted special pages.
• $wgAllowUserCss - Allow user Cascading Style Sheets (CSS)
• $wgAllowUserJs - Allow user Javascript pages
• $wgEnableJavaScriptTest - Allows running of javascript test suites via Special:JavaScriptTest (such as QUnit).
• $wgForcedRawSMaxage - Default maximum age for raw CSS/JS accesses.
• $wgHandheldForIPhone (removed in 1.22), If set, 'screen' and 'handheld' media also apply to the iPhone/iPod Touch Mobile Safari.
• $wgHandheldStyle (removed in 1.22), Style for media="handheld".
• $wgIncludeLegacyJavaScript (deprecated in 1.26) - Whether to include the mediawiki.legacy JS library (old wikibits.js), and its dependencies.
• $wgPreloadJavaScriptMwUtil (removed in 1.27) - Whether to preload the mediawiki.util module as blocking module in the top queue.
• $wgJavaScriptTestConfig (removed in 1.25) - Configuration for javascript testing.
• $wgLegacyJavaScriptGlobals - Whether or not to assign configuration variables to the global window object.
• $wgUseSiteCss - Use the site's Cascading Style Sheets (CSS).
• $wgUseSiteJs - Use the site's Javascript page.

Resource loader

See ResourceLoader for more information.

• $wgResourceBasePath - Default 'remoteBasePath' value for resource loader modules.
• $wgResourceLoaderDebug - The default debug mode (on/off) for of ResourceLoader requests.
• $wgResourceLoaderInlinePrivateModules (removed in 1.19) - Whether to embed private modules inline with HTML output or to bypass caching and check the user parameter against.
• $wgResourceLoaderLESSVars (deprecated in 1.30) - Global LESS variables.
• $wgResourceLoaderMaxage - Maximum time in seconds to cache resources served by the resource loader.
• $wgResourceLoaderMaxQueryLength - Maximum query string length for resource loader requests.
• $wgResourceLoaderMinifierMaxLineLength - Maximum line length when minifying JavaScript.
• $wgResourceLoaderMinifierStatementsOnOwnLine (removed in 1.27) - Put each statement on its own line when minifying JavaScript.
• $wgResourceLoaderSources - Foreign module sources registry.
• $wgResourceLoaderStorageVersion - Cache version for client-side ResourceLoader module storage.
• $wgResourceLoaderUseESI - Enable embedding of certain resources using Edge Side Includes.
• $wgResourceLoaderValidateJS - Whether to parse JavaScript module prior to minification to validate them.
• $wgResourceLoaderValidateStaticJS - Whether to parse statically-sourced (file-backed) JavaScript resources prior to minification to validate them.
• $wgResourceLoaderStorageEnabled - Cache modules in localStorage on supporting browsers.
• $wgResourceModules - Array of all extra defined modules that can later be loaded during the output.

Namespaces

• $wgContentNamespaces - Namespaces which are considered to contain real content, or articles.
• $wgExtraNamespaces - Additional namespaces.
• $wgExtraGenderNamespaces - Same as $wgExtraNamespaces, but for namespaces with gender distinction.
• $wgExtraSignatureNamespaces - Controls in which subject (non-talk) namespaces the "Signature" button on the edit toolbar will be displayed.
• $wgMetaNamespace - The name used for the meta-namespace.
• $wgMetaNamespaceTalk - The name used for the meta-namespace talk pages.
• $wgNamespaceAliases - Additional names for namespaces.
• $wgNamespaceContentModels - Content types defined for a given namespace.
• $wgNamespaceProtection - Default protection levels for namespaces.
• $wgNamespacesToBeSearchedDefault - Which namespaces should be searched?
• $wgNamespacesToBeSearchedHelp (removed in 1.24) - Namespaces to be searched when user clicks the "Help" tab on Special:Search.
• $wgNamespacesWithSubpages - Which namespaces should support subpages?
• $wgNoFollowNsExceptions - Namespaces where the nofollow setting ($wgNoFollowLinksManual:$wgNoFollowLinks) is overridden.
• $wgNonincludableNamespaces - Pages in namespaces in this array can not be used as templates.
• $wgPreviewOnOpenNamespaces - Namespaces that have special treatment where they should be preview-on-open.
• $wgSitemapNamespaces - Array of namespaces to generate a sitemap or false for all namespaces.
• $wgSitemapNamespacesPriorities - Custom namespace priorities for sitemaps.

Output

• $wgAllowMicrodataAttributes (removed in 1.27) - Enable HTML 5 microdata attributes for use in wikitext, if $wgHtml5 is also true.
• $wgAllowRdfaAttributes (removed in 1.27) - Enable RDFa attributes for use in wikitext.
• $wgCleanupPresentationalAttributes (removed in 1.20.1) - Whether to put as much as possible presentational HTML attributes in CSS.
• $wgEnableTooltipsAndAccesskeys (removed in 1.19) - Whether to enable application of access keys and tooltips
• $wgHtml5 (removed in 1.22) - Whether to output an HTML 5 doctype. See HTML5HTML5.
• $wgHtml5Version - Defines the value of the version attribute in the <html> tag, if any.
• $wgWellFormedXml (removed in 1.27) - Whether to try to make our HTML output well-formed XML.
• $wgMimeType - The type to send in the Content-Type header.
• $wgMangleFlashPolicy - Whether to mangle any cross-domain-policy (Adobe cross-domain policy) tags, to prevent XSS attacks.
• $wgSend404Code - Send 404 HTTP status for not found pages.
• $wgEnableCanonicalServerLink - Output a <link rel="canonical"> tag on every page indicating the canonical server which should be used, i.e. $wgServer or $wgCanonicalServer.
• $wgUseMediaWikiUIEverywhere - Applies MediaWiki UI wherever it can be supported.
• $wgHTMLFormAllowTableFormat - Allow form components to render tables.
• $wgXhtmlNamespaces - Permit other namespaces in addition to the w3.org default.

The following settings are only used if $wgHtml5 is set to "false" (removed in 1.22):

• $wgDocType (removed in 1.22) - The doc type to use in the <!DOCTYPE !> declaration.
• $wgDTD (removed in 1.22) - Specifies the DTD in the DOCTYPE declaration for page output.
• $wgXhtmlDefaultNamespace (removed in 1.22) - Default XHTML namespace

Robot policies

• $wgArticleRobotPolicies - Allow customisation of robot policies on a per-article basis.
• $wgDefaultRobotPolicy - Default robot exclusion policy for the wiki.
• $wgExemptFromUserRobotsControl - An array of namespace keys in which the __INDEX__/__NOINDEX__ magic words will not function.
• $wgNamespaceRobotPolicies - Allow customisation of robot policies on a per-namespace basis.

Mobile support

• $wgDeviceDetectionClass (removed in 1.21) - Name of the class used for mobile device detection.

Site Statistics

• $wgArticleCountMethod - Method used to determine if a page in a content namespace should be counted as a valid article.
• $wgContentNamespaces - Namespaces which are considered to contain real content, or articles (affects Special:Random and Special:Statistics).
• $wgCountCategorizedImagesAsUsed - On Special:Unusedimages, consider images used if they are put into a category.
• $wgDisableCounters (removed in 1.25) - Disable view counter shown in the footer of an article/page as: "This page has been accessed X times"
• $wgHitcounterUpdateFreq (removed in 1.25) - Sets how often page counters should be updated.
• $wgStatsdSamplingRates - Sampling rate for statsd metrics as an associative array of patterns and rates
• $wgUseCommaCount (removed in 1.24) - Specifies the criteria used to define a 'valid article' when counting.
• $wgSiteStatsAsyncFactor - Sets how often site statistics should be updated.
• $wgWantedPagesThreshold - Minimum number of links required before a page is listed on Special:Wantedpages

Skins

• $wgDefaultSkin - The default skin.
• $wgFooterIcons - Fallback skin used when the skin defined by $wgDefaultSkin can't be found.
• $wgFallbackSkin - Abstract list of footer icons for skins in place of old copyrightico and poweredbyico code.
• $wgLocalStylePath - Same as $wgStylePathManual:$wgStylePath, but shouldn't point to an external domain.
• $wgSkipSkin (deprecated in 1.23) - Specify the name of a skin that should not be presented in the list of available skins.
• $wgSkipSkins - More of the same as $wgSkipSkin.
• $wgStyleDirectory - The file system path to the skins directory.
• $wgStylePath - The URL of the skins directory.
• $wgUseCombinedLoginLink - Login / create account link behavior when it's possible for anonymous users to create an account.
• $wgValidSkinNames - List of valid skin names.
• $wgVectorUseSimpleSearch - Search form behavior for Vector skin only.
• $wgVectorUseIconWatch - Watch and unwatch as an icon rather than a link for Vector skin only.

Category

• $wgCategoryCollation - A version indicator for collations that will be stored in cl_collation for all new rows.
• $wgCategoryMagicGallery - On category pages, show thumbnail gallery for images belonging to that category instead of listing them as articles.
• $wgCategoryPagingLimit - Paging limit for items in categories.
• $wgUseCategoryBrowser - Enable DMOZ-like category tree at the bottom of pages
• $wgTrackingCategories‎ - List of messages representing tracking categories

Cache

主页面： Manual:Caching

• $wgCacheDirectory - Directory for caching data in the local filesystem.
• $wgCacheEpoch - Set this to current time to invalidate all prior cached pages.
• $wgCachePrefix - Overwrite the caching key prefix with custom value.
• $wgClockSkewFudge - Helps avoid cache problems due to timer resolution.
• $wgDBAhandler (removed in 1.23) - Selects which DBA handler to use.
• $wgInvalidateCacheOnLocalSettingsChange - Setting this to true will invalidate all cached pages whenever LocalSettings.php is changed.
• $wgLanguageConverterCacheType - The cache type for storing language conversion tables.
• $wgMainCacheType - Replaces $wgUseMemCachedManual:$wgUseMemCached.
• $wgObjectCaches - Advanced object cache configuration.
• $wgObjectCacheSessionExpiry - The expiry time to use for session storage when $wgSessionsInObjectCacheManual:$wgSessionsInObjectCache is enabled, in seconds.
• $wgQueryCacheLimit - Number of rows to cache in 'querycache' table when miser mode is on.
• $wgRevisionCacheExpiry - Cache extracted revision text in MemCached.
• $wgThumbnailEpoch - If rendered thumbnail files are older than this timestamp, they will be rerendered on demand as if the file didn't already exist.
• $wgUseETag (removed in 1.28) - Whether MediaWiki should send an ETag header.
• $wgUseGzip - Use GZip to store cached pages.
• $wgUpdateRowsPerQuery - Number of rows to update per query.
• $wgSessionsInMemcached (deprecated in 1.20) - Store session data in the object cache, rather than on the filesystem.
• $wgSessionCacheType - The cache type for storing session data.
• $wgSessionsInObjectCache (deprecated in 1.27) - Whether to store sessions in object cache.

See: Interwiki for Interwiki cache settings.

Client side caching

• $wgCachePages - Allow client-side caching of pages

File Cache

Settings for Server side file caching.

• $wgFileCacheDepth - Depth of the subdirectory hierarchy to be created under $wgFileCacheDirectory.
• $wgFileCacheDirectory - Directory where the cached page will be saved when using server-side caching.
• $wgUseFileCache - This will cache static pages for non-logged-in users to reduce database traffic on public sites.

Message Cache

• $wgAdaptiveMessageCache - Instead of caching everything, keep track which messages are requested and load only most used messages.
• $wgLocalisationCacheConf - Localisation cache configuration.
• $wgLocalMessageCacheSerialized (removed in 1.22) - Defines format of local cache.
• $wgMaxMsgCacheEntrySize - Maximum entry size in the message cache, in bytes.
• $wgMessageCacheType - Message cache setting.
• $wgUseLocalMessageCache - Make a local copy of the message cache, in addition to memcached

Sidebar Cache

• $wgEnableSidebarCache - If true, cache the sidebar navigation links.
• $wgSidebarCacheExpiry - Expiry time for the sidebar cache.

Parser Cache

• $wgEnableParserCache (deprecated in 1.26) - Keep parsed pages in a cache (objectcache table, turck, or memcached) to speed up output of the same page viewed by another user with the same options.
• $wgRenderHashAppend - Append a configured value to the parser cache and the sitenotice cache keys.
• $wgParserCacheExpireTime - Expiration time (in seconds) of cached parser information
• $wgParserCacheType - Parser cache setting.

Memcached settings

Settings for configuring the Memcached memory-based object store (if you are using it) docs/memcached.txt has more details.

• $wgMemCachedDebug - Will be set to false in Setup.php, if the server isn't working.
• $wgMemCachedPersistent - Whether to use persistent memcached connections.
• $wgMemCachedServers - Array of Memcached servers.
• $wgMemCachedTimeout - Server connection timeout in microseconds

Interwiki

• $wgDisableHardRedirects - Disable redirects to special pages and interwiki redirects, which use a 302 and have no "redirected from" link.
• $wgEnableScaryTranscluding - Enable "scary 嵌入transclusion" (transcluding from another wiki)
• $wgExtraInterlanguageLinkPrefixes - Extra interwiki prefixes to treat as language code
• $wgImportSources - List of interwiki prefixes for wikis we'll accept as sources for Special:Import (for sysops).
• $wgLocalInterwiki (deprecated in 1.23) - The interwiki prefix of this wiki.
• $wgLocalInterwikis - The interwiki prefixes of this wiki.
• $wgRedirectSources - Regular expression to restrict URLs which will be displayed as 'redirected from' links.
• $wgTranscludeCacheExpiry - Expiry time for interwiki transclusion.

Interwiki cache

See interwiki cache for more information.

• $wgInterwikiCache - Whether to enable the interwiki cache.
• $wgInterwikiExpiry - Expiry time for cache of interwiki table.
• $wgInterwikiFallbackSite - Used by maintenance scripts to dump interwiki table.
• $wgInterwikiScopes - Used by getInterwikiCache() to retrieve from interwiki database file.

Access

Wiki locking, blocking/banning, and some other related settings.

• $wgActions - Array of allowed values for the "action" parameter for normal pages.
• $wgAutopromote - Conditions of automatic promotion of user to specific groups.
• $wgAutopromoteOnce - Automatically add a usergroup to any user who matches certain conditions.
• $wgAccountCreationThrottle - Number of accounts each IP address may create, 0 to disable. Requires memcached.
• $wgAllowPageInfo (removed in 1.20) - Allow the info action, very inefficient at the moment.
• $wgBlockCIDRLimit - Maximum CIDR range when blocking an IP range.
• $wgDeleteRevisionsLimit - Integer of how many revisions an article must have before the bigdelete right is required to delete it.
• $wgDisabledActions (removed in 1.23) - Array of disabled article actions, e.g. view, edit, dublincore, delete, etc.
• $wgEnableCascadingProtection (removed in 1.13) - Enable cascade protection.
• $wgFilterCallback (deprecated in 1.17) - Similarly (to $wgSpamRegexManual:$wgSpamRegex) if this function returns true.
• $wgInvalidPasswordReset - Specifies if users should be sent to a password-reset form on login in case of an inadequate password.
• $wgNewPasswordExpiry - The time, in seconds, when an emailed temporary password expires.
• $wgPasswordAttemptThrottle - Limit password attempts per IP per address.
• $wgPasswordConfig - Configuration for built-in password types.
• $wgPasswordDefault - Default password type to use when hashing user passwords.
• $wgPasswordResetRoutes - Whether to allow password resets identified by various bits of data.
• $wgPasswordSalt (deprecated in 1.24) - For compatibility with old installations set to false.
• $wgRangeContributionsCIDRLimit - Shortest CIDR limits that can be checked in any individual range check at Special:Contributions.
• $wgRestrictionTypes - Actions that can be restricted.
• $wgSpamRegex - A regular expression pattern which stops a page from being saved.
• $wgSummarySpamRegex - Same as $wgSpamRegex except for edit summaries
• $wgCookieSetOnAutoblock - (since 1.29) Determines whether to set a cookie when a user is autoblocked. Doing so means that a blocked user, even after logging out and moving to a new IP address, will still be blocked. This is false by default.
• $wgSoftBlockRanges - (since 1.29) IP ranges that should be considered soft-blocked (anon-only, account creation allowed).

See Manual:Preventing access for more methods and settings concerning access. See also Manual:User rights</> for more information about $wgGroupPermissions, $wgAddGroups, $wgRemoveGroups, etc.

See User Access for User Access settings.

Rate limiter

• $wgRateLimitLog (removed in 1.27) - Set to a filename to log rate limiter hits.
• $wgRateLimits - Simple rate limiter options to brake edit floods.
• $wgRateLimitsExcludedIPs - Array of IPs which should never trigger the rate limiter.

API

• $wgEnableAPI - Enable direct access to the data API through api.php.
• $wgEnableWriteAPI - Allow the API to be used to perform write operations (page edits, rollback, etc.) when an authorised user accesses it.
• $wgCrossSiteAJAXdomains - Allow the API to be accessed by cross domain AJAX from specified domains
• $wgCrossSiteAJAXdomainExceptions - Domains that should not be allowed to make AJAX requests, even if they match one of the domains allowed by $wgCrossSiteAJAXdomains
• $wgAPICacheHelpTimeout - Set the timeout for the API help text cache.
• $wgApiFrameOptions - Control framing of api pages.
• $wgAPIRequestLog - Log file or URL (TCP or UDP) to log API requests to
• $wgAPIUselessQueryPages - The ApiQueryQueryPages module should skip pages that are redundant to true API queries.

Wiki locking

• $wgReadOnly - Disallows editing, displaying the string given as the reason.
• $wgReadOnlyFile - If this file is found, the database is locked for the reason given in the contents of the file.

Reduction

• $wgAPIMaxDBRows - Maximum number of rows to scan in a DB query in the API.
• $wgAPIMaxResultSize - The maximum size (in bytes) of an API result.
• $wgAPIMaxUncachedDiffs - The maximum number of uncached diffs that can be retrieved in one API request.
• $wgQueryPages (removed in 1.23) - Replaced by the wgQueryPagesManual:Hooks/wgQueryPages hook.
• $wgDisableQueryPages - Disable all query pages if miser mode is on, not just some.
• $wgDisableQueryPageUpdate - Array of special pages that should not be updated.
• $wgDisableSearchUpdate - If you've disabled search semi-permanently, this also disables updates to the table.
• $wgDisableTextSearch - Disables full text search (including title search).
• $wgEdititis - Display user edit counts in various prominent places.
• $wgFixDoubleRedirects - Fix double redirects after a page move.
• $wgInvalidRedirectTargets - Array of invalid page redirect targets.
• $wgMaximumMovedPages - Maximum number of pages to move at once when moving subpages with a page.
• $wgMiserMode - If true, disable database-intensive features
• $wgShowHostnames - If set to true, exposes host names through API and HTML comments.
• $wgShowRollbackEditCount - Maximum number to count when a rollback link is shown.
• $wgUseDumbLinkUpdate (removed in 1.22) - Do DELETE/INSERT for link updates instead of incremental.

Uploads

Uploads have to be specially set up to be secure.

• $wgAjaxLicensePreview - Allow preview licences during upload via AJAX.
• $wgAllowCopyUploads - Allow uploads from URLs, not just local files.
• $wgCopyUploadsDomains - Domains that are allowed to be used in upload from URLs.
• $wgAllowJavaUploads - Allow Java archive uploads.
• $wgAsyncHTTPTimeout - Timeout for asynchronous http request.
• $wgCheckFileExtensions - This is a flag to determine whether or not to check file extensions on upload.
• $wgCopyUploadProxy - Proxy to use for copy upload requests.
• $wgAllowAsyncCopyUploads (removed in 1.27) - Allow asynchronous copy uploads.
• $wgDisableUploadScriptChecks - Whether to disable the upload system's checks for HTML/JavaScript.
• $wgEnableUploads - Enables uploads and shows link to upload page
• $wgFileBackends - File backend structure configuration.
• $wgFileBlacklist - Files with these extensions will never be allowed as uploads.
• $wgFileExtensions - This is the list of preferred extensions for uploading files. Uploading files with extensions not in this list will trigger a warning.
• $wgFileStore (removed in 1.24) - Indicates where deleted images are to be stored.
• $wgHashedUploadDirectory - If true, use the /a/ab/foo.png directory structure.
• $wgHTTPTimeout - Timeout for HTTP requests done via CURL.
• $wgHTTPProxy - Proxy to use for CURL requests.
• $wgImgAuthDetails - Display reason access to uploaded file was denied to users(img_auth only)
• $wgImgAuthPublicTest (removed in 1.24) - Test to see if img_auth set up correctly (img_auth only)
• $wgLocalFileRepo - A single repository structure for the local repository.
• $wgLockManagers - Array of configuration arrays for each lock manager.
• $wgMinUploadChunkSize - Minimum upload chunk size, in bytes.
• $wgStrictFileExtensions - If this is turned off, users may override the warning for files not covered by $wgFileExtensionsManual:$wgFileExtensions.
• $wgUploadBaseUrl - The base URL for uploaded images if shared upload directory isn't to be used
• $wgUploadDirectory - The file system path of the upload directory.
• $wgDeletedDirectory - What directory to place deleted uploads in
• $wgUploadMaintenance - To disable image delete/restore temporarily.
• $wgUploadMissingFileUrl - Point the upload link for missing files to an external URL.
• $wgUploadNavigationUrl - Point the upload navigation link to an external URL.
• $wgUploadPath - The URL of the upload directory.
• $wgUploadSizeWarning - Warn if uploaded files are larger than this.
• $wgUploadStashMaxAge - The maximum age of temporary (incomplete) uploaded files.
• $wgUploadStashScalerBaseUrl - To enable remote on-demand scaling, set this to the thumbnail base URL.
• $wgMaxUploadSize - Maximum size for file uploads.
• $wgSaveDeletedFiles (removed in 1.11) - Indicates that deleted images are to be stored for later undeletion.

Shared uploads

These settings are kept for backward compatibility, see $wgForeignFileRepos for the new setting, or $wgUseInstantCommonsManual:$wgUseInstantCommons if you only need read access to images on Commons.

• $wgCacheSharedUploads - Cache shared metadata in memcached.
• $wgForeignFileRepos - An array of repository structure for foreigns repositories.
• $wgHashedSharedUploadDirectory - Whether to hash the shared upload directory.
• $wgRepositoryBaseUrl - Base URL for a repository wiki.
• $wgSharedUploadDBname - DB name with metadata about shared directory.
• $wgSharedUploadDBprefix - DB prefix for shared image uploads.
• $wgSharedUploadDirectory - Path on the file system where shared uploads can be found.
• $wgSharedUploadPath - Full path on the web server where shared uploads can be found.
• $wgUseSharedUploads - Whether to look in the shared repository if no file of the given name is found in the local repository (for [[Image:..]], [[Media:..]] links).
• $wgFetchCommonsDescriptions - set this "true" if you want to integrate media-descriptions, stored in the commonswiki

MIME types

• $wgJsMimeType (removed in 1.22) - Media type (MIME type) to use for JavaScript scripts.
• $wgLoadFileinfoExtension (removed in 1.22) - Switch for loading the FileInfo extension by PECL at runtime.
• $wgMimeDetectorCommand - Sets an external mime detector program.
• $wgMimeInfoFile - Sets the mime type info file to use by MimeMagic.phpManual:MimeMagic.php.
• $wgMimeTypeFile - Sets the mime type definition file to use by MimeMagic.phpManual:MimeMagic.php.
• $wgTrivialMimeDetection - Switch for trivial mime detection.

警告： This is not a configuration setting, but a global state variable. It should be used solely by thumb.php!

• $wgVerifyMimeType - Determines if the mime type of uploaded files should be checked
• $wgMimeTypeBlacklist - Files with these mime types will never be allowed as uploads if $wgVerifyMimeType is enabled.
• $wgXMLMimeTypes - An array of XML mime types we can detect via MimeMagic.

See also: Manual:Mime type detection

Images

• $wgAllowImageMoving - Allow to move images
• $wgCustomConvertCommand - Use another resizing converter, e.g. GraphicMagick.
• $wgEnableAutoRotation - Whether to enable image auto-rotation based on Exif information
• $wgExiv2Command - Path to the exiv2 executable.
• $wgGalleryOptions - Default parameters for the <gallery> tag.
• $wgIgnoreImageErrors - If true, inline scaled images will still produce <img> tags ready for output instead of showing an error message.
• $wgImageLimits - Limit images on image description pages to a user-selectable limit.
• $wgJpegTran - Path to the jpegtran utility.
• $wgMaxImageArea - Don't thumbnail an image if it will use too much working memory.
• $wgMediaHandlers - Plugins for media file type handling.
• parameters for upload path
• $wgTrustedMediaFormats - List of trusted media-types and mime types.

See also: Manual:Configuring file uploads

DjVu

• $wgDjvuDump - Path of the djvudump executable.
• $wgDjvuOutputExtension - File extension for the DJVU post processor output.
• $wgDjvuPostProcessor - Path of the DJVU post processor.
• $wgDjvuRenderer - Path of the ddjvu DJVU renderer.
• $wgDjvuToXML - Path of the djvutoxml executable.
• $wgDjvuTxt - Path of the djvutxt DJVU text extraction utility.

EXIF

• $wgShowEXIF - Determines whether EXIF metadata is to be displayed. Set to false for not showing data.
• $wgUpdateCompatibleMetadata - Whether to automatically update the img_metadata field if the metadata field is outdated but compatible with the current version.

ImageMagick

• $wgImageMagickConvertCommand - The convert command shipped with ImageMagick.
• $wgImageMagickIdentifyCommand (removed in 1.23) - The identify command shipped with ImageMagick
• $wgImageMagickTempDir - Temporary directory used for ImageMagick.
• $wgSharpenParameter - Sharpening parameter to ImageMagick.
• $wgSharpenReductionThreshold - Reduction in linear dimensions below which sharpening will be enabled.
• $wgUseImageMagick - Resizing can be done using PHP's internal image libraries or using ImageMagick. The latter supports more file formats than PHP, which only supports PNG, GIF, JPG, XBM and WBMP.
• $wgUseTinyRGBForJPGThumbnails - When this variable is true and JPGs use the sRGB ICC profile, swaps it for the more lightweight (and free) TinyRGB profile when generating thumbnails.

Set $wgUseImageMagick to true to use ImageMagick instead of the builtin functions.

SVG

• $wgAllowTitlesInSVG - If true, <title> will be allowed in files with an "image/svg" MIME type.
• $wgSVGConverter - A key from $wgSVGConverters to use as converter.
• $wgSVGConverterPath - If not in the executable PATH, specify.
• $wgSVGConverters - Scalable Vector Graphics (SVG) may be uploaded as images.
• $wgSVGMaxSize - Don't scale a SVG larger than this unless its native size is larger.
• $wgSVGMetadataCutoff - Don't read SVG metadata beyond this point.

Thumbnail settings

• $wgUseImageResize - Set $wgUseImageResize to true if you want to enable dynamic server side image resizing (Thumbnails)
• $wgGenerateThumbnailOnParse - Allow thumbnail rendering on page view.
• $wgMaxAnimatedGifArea - Force thumbnailing of animated GIFs above this size to a single frame instead of an animated thumbnail.
• $wgSharedThumbnailScriptPath - Same as $wgThumbnailScriptPath, but for shared uploads.
• $wgShowArchiveThumbnails - Whether to show thumbnails for old images on the image description page.
• $wgTiffThumbnailType - Array of extension and mime type to transform TIFF images to.
• $wgThumbnailScriptPath - Give a path here to use thumb.phpManual:Thumb.php for thumbnail generation on client request, instead of generating them on render and outputting a static URL.
• $wgThumbUpright - Adjust width of upright images when parameter 'upright' is used.
• $wgThumbLimits - List of image sizes users can pick from.
• $wgResponsiveImages - Use responsive images for high-density displays.
• $wgThumbnailBuckets - List of intermediary thumbnail sizes to use to speed up thumbnail rendering.
• $wgThumbnailMinimumBucketDistance - Minimal distance between intermediary thumbnail size and target thumbnail size.
• $wgJpegPixelFormat - Sets YUV chroma subsampling mode for JPEG thumbnails

Antivirus

• $wgAntivirus - Internal name of virus scanner.
• $wgAntivirusRequired - Determines if a failed virus scan (AV_SCAN_FAILED) will cause the file to be rejected.
• $wgAntivirusSetup - Configuration for different virus scanners.

Parser

• $wgAllowDisplayTitle - Allow the magic word {{DISPLAYTITLE:}} to override the title of a page.
• $wgAllowExternalImages - Whether to allow inline image pointing to other websites.
• $wgAllowExternalImagesFrom - If $wgAllowExternalImagesManual:$wgAllowExternalImages is false, you can specify exceptions here.
• $wgAllowSlowParserFunctions - Allow slow parser functions like "pagesinnamespace".
• $wgAllowImageTag - Allow <img> tag to be used in wikitext.
• $wgEnableImageWhitelist - If $wgAllowExternalImagesManual:$wgAllowExternalImages is false, this will enable an on-wiki image whitelist at MediaWiki:External image whitelistMediaWiki:External image whitelist.
• $wgCleanSignatures - If true, removes (substitutes) templates in "~~~~" signatures.
• $wgExperimentalHtmlIds - Should we allow a broader set of characters in id attributes, per HTML5?
• $wgExpensiveParserFunctionLimit - Maximum number of calls per parse to expensive parser functions such as PAGESINCATEGORY.
• $wgExternalLinkTarget - Set a default target for external links.
• $wgGrammarForms - Used for {{GRAMMAR:}} parser function.
• $wgLinkHolderBatchSize - LinkHolderArray batch size.
• $wgMaxGeneratedPPNodeCount - A complexity limit on template expansion: the maximum number of nodes generated by Preprocessor::preprocessToObj()
• $wgMaxPPExpandDepth - Stack depth limit for expansion with the preprocessor.
• $wgMaxPPNodeCount - A complexity limit on template expansion: the maximum number of nodes visited by PPFrame::expand()
• $wgMaxTemplateDepth - Maximum recursion depth for templates within templates.
• $wgMaxTocLevel - Maximum indent level of the Table of ContentsTable of Contents.
• $wgParserConf - Parser configuration.
• $wgParserTestFiles - Parser test suite files to be run by parserTests.php.
• $wgParserTestRemote (removed in 1.24) - Specifies target CodeReview installation to send test result data from "parserTests.php --upload"
• $wgPreprocessorCacheThreshold - Preprocessor caching threshold.
• $wgRegisterInternalExternals - Whether to register external links pointing to the same server.
• $wgRestrictDisplayTitle - Restrict DISPLAYTITLE to titles that normalize to the same canonical DB key.

HTML

• $wgRawHtml - Allow raw, unchecked HTML in <html>...</html> sections.

Tidy

Tidy is an open source tool that cleans up broken HTML. You can use this to ensure that broken HTML in articles doesn't affect the layout of your wiki. While Tidy itself is going to be replaced, the configuration settings can still be used for the replacements.

• $wgTidyConfig - Configuration of the HTML postprocessing tool to use for fixing invalid HTML code.
• $wgAlwaysUseTidy (deprecated in 1.26)
• $wgDebugTidy - Put tidy warnings in HTML comments, only works for internal tidy.
• $wgTidyBin (deprecated in 1.26) - Should be set to the path of the tidy binary.
• $wgTidyConf (deprecated in 1.26) - Should be set to the path of the tidy configuration file.
• $wgTidyInternal (deprecated in 1.20)- Controls the use of the PECL extension to use an inprocess tidy library instead of spawning a separate program.
• $wgTidyOpts (deprecated in 1.26) - Options passed to tidy on the command line.
• $wgUseTidy (deprecated in 1.26) - Use tidy to make sure HTML output is sane.
• $wgValidateAllHtml - Validate the overall output using tidy and refuse to display the page if it's not valid.

See also: Manual:Build Tidy from source.

Special pages

• $wgActionFilteredLogs - List of log types that can be filtered by action types
• $wgAllowSpecialInclusion - Allow special page inclusions such as {{Special:Allpages}}.
• $wgExportAllowAll - Whether to allow exporting the entire wiki into a single file.
• $wgExportAllowHistory - Enable the full-history option on Special:Export.
• $wgExportAllowListContributors - Whether to allow to list all contributors while exporting a page.
• $wgExportFromNamespaces - Whether to allow the "export all pages in namespace" option
• $wgExportMaxHistory - Special:Export requests for history of pages with more revisions than this will be rejected.
• $wgExportMaxLinkDepth - Maximum value of the "pagelink-depth" parameter in Special:Export.
• $wgExportPagelistLimit - Maximum number of pages returned by the GetPagesFromCategory and GetPagesFromNamespace functions.
• $wgFilterLogTypes - Show/hide links on Special:Log will be shown for these log types
• $wgImportTargetNamespace - Optional default target namespace for interwiki imports.
• $wgLogActions - Lists the message key string for formatting individual events of each type and action when listed in the logs.
• $wgLogActionsHandlers - Same as $wgLogActionsManual:$wgLogActions, but values are functions callbacks.
• $wgLogHeaders - Lists the message key string for descriptive text to be shown at the op of each log type.
• $wgLogNames - Lists the message key string for each log type.
• $wgLogRestrictions - Restricts log access to those who have a certain right.
• $wgLogTypes - List of log types.
• $wgQueryPageDefaultLimit - Default number of entries to show on query pages.
• $wgMaxRedirectLinksRetrieved - Maximum number of links to a redirect page listed on Special:Whatlinkshere/RedirectDestination.
• $wgRedirectOnLogin - Redirect a user to a specific page when they log in.
• $wgSecureLogin - Whether to let user authenticate using https when they come from http.
• $wgSortSpecialPages (removed in 1.24) - Whether or not to sort special pages in Special:Specialpages.
• $wgSpecialPageGroups (removed in 1.26) - List of special pages, followed by what subtitle they should go under at Special:SpecialPages
• $wgSpecialVersionShowHooks - Whether to show the contents of $wgHooks in Special:Version.
• $wgUseNPPatrol - Use new pages patrolling to check for vandalism.

Recent changes

See also Help:Recent changes and $wgDefaultUserOptions

• $wgAllowCategorizedRecentChanges - Allow to filter the recentchanges by a category or one of its sub(subsubsub...)categories
• $wgAutopromoteOnceLogInRC - Whether to put user rights log entries for autopromotion in recent changes
• $wgPutIPinRC - Log IP addresses in the recentchanges table.
• $wgRCChangedSizeThreshold - Highlight character count difference lower than this.
• $wgRCFilterByAge - Filter $wgRCLinkDays to avoid showing links for values higher than $wgRCMaxAge.
• $wgRCLinkLimits - Changes limit.
• $wgRCLinkDays - Days limit.
• $wgRCMaxAge - Recentchanges items are periodically purged; entries older than this many seconds will go.
• $wgRCShowChangedSize - Show the amount of changed characters in recent changes.
• $wgRCShowWatchingUsers - Show watching users in recent changes, watchlist and page history views.
• $wgShowUpdatedMarker - Show "Updated (since my last visit)" marker in RC view, watchlist and history.
• $wgUseRCPatrol - Use RC Patrolling to check for vandalism.
• $wgWatchersMaxAge - Page watchers inactive for more than this many seconds are considered inactive.
• $wgUnwatchedPageSecret - If active watchers (per above) are this number or less, do not disclose it.

UDP updates

Send Recent changes updates via UDP. See: Manual:Simple IRC RC Bot

• $wgRCEngines - Feed engine configuration
• $wgRCFeeds - Feed formatting and destination configuration
• $wgRC2UDPAddress (removed in 1.24) - Address used.
• $wgRC2UDPInterwikiPrefix (removed in 1.24) - Whether to prefixes the page name used in the RC feed.
• $wgRC2UDPOmitBots (removed in 1.24) - Omit bot.
• $wgRC2UDPPort (removed in 1.24) - Port used.
• $wgRC2UDPPrefix (removed in 1.24) - Prefix used.

Users

• $wgActiveUserDays - The number of days a person must be idle before they're considered inactive
• $wgAutoConfirmAge - Number of seconds an account is required to age before it's given the implicit 'autoconfirm' group membership.
• $wgAutoConfirmCount - Number of edits an account requires before it's given the implicit 'autoconfirm' group membership.
• $wgAllowUserCssPrefs - Whether to allow user-preferences implemented in CSS
• $wgDefaultUserOptions - Settings added to this array will override the default settings for the user preferences used by anonymous visitors and newly created accounts.
• $wgDisableAnonTalk - Disable talk pages for anonymous users (IPs).
• $wgHiddenPrefs - Disable certain user preferences.
• $wgHKDFAlgorithm - Algorithm for HMAC-based key derivation function (fast, cryptographically secure random numbers).
• $wgHKDFSecret - Secret for HMAC-based key derivation function (fast, cryptographically secure random numbers).
• $wgInvalidUsernameCharacters - Characters to prevent during new account creations.
• $wgMaxNameChars - Maximum number of bytes in username.
• $wgMaxSigChars - Maximum customized signature length.
• $wgMinimalPasswordLength (deprecated in 1.26) - Specifies the minimal length of a user password.
• $wgNewUserLog - Whether to maintain a log of newusers at Special:Log/newusers.
• $wgPasswordExpirationDays - Number of days after which user passwords expire.
• $wgPasswordExpireGrace - Grace period for password expiry.
• $wgPasswordPolicy - Specifies various settings related to password strength and security.
• $wgReservedUsernames - List of account names that cannot exist.
• $wgShowIPinHeader (removed in 1.27) - Show the IP in the user bar for anonymous users by default.
• $wgUserrightsInterwikiDelimiter - Character used as a delimiter when testing for interwiki userrights.

Authentication

• $wgSessionProviders - Session provider configuration.
• $wgAuthManagerAutoConfig - Register authentication providers to use with AuthManager.
• $wgAuthManagerConfig - Manual override for authentication provider configuration.
• $wgCentralIdLookupProvider - Default central id lookup implementation to use.
• $wgCentralIdLookupProviders - Register central ID lookup providers.
• $wgAuthenticationTokenVersion - When changed, all existing sessions are invalidated.
• $wgReauthenticateTime - Time frame for re-authentication.
• $wgAllowSecuritySensitiveOperationIfCannotReauthenticate - Whether to allow security-sensitive operations when reauthentication is not possible.
• $wgExternalAuthType (removed in 1.22) - Use some particular type of external authentication.
• $wgExternalAuthConf (removed in 1.22) - Configuration for the external authentication.
• $wgAutocreatePolicy (removed in 1.22) - Policy to create new accounts with external authentication.
• $wgAllowPrefChange (removed in 1.22) - Policies for how each preference is allowed to be changed, in the presence of external authentication.

User Access

• $wgAddGroups - Controls who can add specific groups using Special:Userrights.
• $wgAutoblockExpiry - Number of seconds before autoblock entries expire.
• $wgBlockAllowsUTEdit - Allow blocked users to edit their talk pages.
• $wgBlockDisablesLogin - Disallow blocked users to login.
• $wgEmailConfirmToEdit - Require users to confirm email address before they can edit, true to enable.
• $wgGrantPermissions - Used to define grants and assign permissions to them.
• $wgGrantPermissionGroups - Used to define grant groups and assign grants to them.
• $wgGroupPermissions - Use this to set access rights for groups and users. See also 手册:用户权限Manual:User rights
• $wgGroupsAddToSelf - allow users to add themselves from specified groups via Special:Userrights
• $wgGroupsRemoveFromSelf - allow users to remove themselves from specified groups via Special:Userrights
• $wgImplicitGroups - Array of groups that aren't shown on e.g. Special:Listusers.
• $wgRemoveGroups - Controls who can remove specific groups using Special:Userrights.
• $wgRevokePermissions - Rights revoked from users in each group.
• $wgWhitelistRead - Pages anonymous user may see.

User agent

• $wgBrowserBlackList - Browser blacklist for Unicode non compliant browsers.

Cookies

• $wgCacheVaryCookies - A list of cookies that vary the cache.
• $wgCookieDomain - Set to set an explicit domain on the login cookies.
• $wgCookieExpiration - Number of seconds before HTTP cookies expire.
• $wgCookieHttpOnly - Set authentication cookies to httpOnly to prevent stealing by JS, in browsers that support this feature.
• $wgCookiePath - Explicitly declared "path" for cookies at the cookie domain.
• $wgCookiePrefix - Custom cookie prefix.
• $wgCookieSecure - Whether cookies are secured.
• $wgDisableCookieCheck - Disables session cookies.
• $wgExtendedLoginCookieExpiration - Duration in seconds to use for "Keep me logged in" sessions.
• $wgHttpOnlyBlacklist (removed in 1.23) - User agent blacklist for HttpOnly mode.
• $wgSessionHandler (deprecated in 1.27) - Used to set php's session.save_handler.
• $wgSessionName - Override to customise the session name.

Feed

• $wgFeed - Toggle syndication feeds on and off.
• $wgAdvertisedFeedTypes - Which feed types should be provided by default.
• $wgFeedCacheTimeout - 'Minimum' timeout for cached Recentchanges feed, in seconds.
• $wgFeedClasses - Available feeds objects.
• $wgFeedDiffCutoff - When generating Recentchanges RSS/Atom feed, diffs will not be generated for pages larger than this size.
• $wgFeedLimit - Set maximum number of results to return in syndication feeds (RSS, Atom) for eg Recentchanges, Newpages.
• $wgOverrideSiteFeed - Override the site's default rss/atom feed that appears on every page.

Copyright

• $wgCopyrightIcon (removed in 1.27) - Set this to some HTML to override the copyrights icon with an arbitrary logo.
• $wgEnableCreativeCommonsRdf (removed in 1.19) - Includes licensing information derived from Creative Commons licenses.
• $wgEnableDublinCoreRdf (removed in 1.19) - Use RDF metadata
• $wgLicenseTerms (removed in 1.23) - Array of metadata terms.
• $wgMaxCredits - Set this to the number of authors that you want to be credited below an article text.
• $wgRightsIcon - Copyright icon
• $wgRightsPage - Page describing the site license
• $wgRightsText - Text describing the site license
• $wgRightsUrl - URL describing the site license
• $wgShowCreditsIfMax - If there are more than $wgMaxCreditsManual:$wgMaxCredits authors, show $wgMaxCredits of them.
• $wgUseCopyrightUpload - Set this to true if you want detailed copyright information forms on Upload.

Search

• $wgVectorUseSimpleSearch - For Vector skin only. Set true to use one icon search button. Set false to use separate Go & Search buttons.
• $wgAdvancedSearchHighlighting - Set to true to have nicer highlighted text in search results.
• $wgEnableMWSuggest (removed in 1.20) - Enable suggestions while typing in search boxes.
• $wgGoToEdit (removed in 1.24) - Go button goes straight to the edit screen if the article doesn't exist.
• $wgMWSuggestTemplate (removed in 1.20) - Template for internal MediaWiki suggestion engine.
• $wgEnableOpenSearchSuggest - Enable OpenSearch suggestions requested by MediaWiki.
• $wgOpenSearchTemplate (deprecated in 1.25) - Template for OpenSearch suggestions.
• $wgEnableSearchContributorsByIP - Whether searching for an IP address will be redirected to that IP's contributions page.
• $wgSearchForwardUrl - Set this to a URL to forward search requests to some external location.
• $wgSearchEverythingOnlyLoggedIn (removed in 1.24) - If set to true the 'searcheverything' preference will be effective only for logged-in users.
• $wgSearchHighlightBoundaries - Regexp to match word boundaries.
• $wgSearchSuggestCacheExpiry - Expiry time for search suggestion responses.
• $wgCountTotalSearchHits (removed in 1.24) - Whether have the default search engine count total search matches to present in the Special:Search UI.
• $wgUseTwoButtonsSearchForm - Sidebar's search form behavior

Jobs

• $wgJobRunRate - Speed of the background task job queue (e.g. update of links).
• $wgRunJobsAsync - When $wgJobRunRate > 0, try to run jobs asynchronously, spawning a new process to handle the job execution, instead of blocking the request until the job execution finishes.
• $wgJobClasses - Maps jobs to their handling classes.
• $wgJobTypesExcludedFromDefaultQueue - Jobs that must be explicitly requested, i.e. aren't run by job runners unless special flags are set.
• $wgUpdateRowsPerJob - Number of rows to update per job.
• $wgJobBackoffThrottling - Limits how often jobs of a given type can run.
• $wgMaxBacklinksInvalidate (removed in 1.23) - Limits the maximum number of backlinks that can be invalidated when a page is editted.
• $wgJobTypeConf - Configuration for job storage.
• $wgJobQueueAggregator - Which aggregator to use for tracking which queues have jobs.

Proxies

• $wgBlockOpenProxies (removed in 1.22) - Automatic open proxy test on edit.
• $wgEnableSorbs (removed in 1.24) - Use http.dnsbl.sorbs.net to check for open proxies.
• $wgSorbsUrl (removed in 1.14) - URL to the Sorbs blacklist.
• $wgEnableDnsBlacklist - Whether to use DNS blacklists in $wgDnsBlacklistUrls to check for open proxies
• $wgDnsBlacklistUrls - List of DNS blacklists to use, if $wgEnableDnsBlacklist is true
• $wgProxyKey (removed in 1.24) - Replaced by $wgSecretKeyManual:$wgSecretKey.
• $wgProxyList - Big list of banned IP addresses.
• $wgProxyMemcExpiry (removed in 1.22) - expiration time for cached proxy IPs.
• $wgProxyPorts (removed in 1.22) - Ports we want to scan for a proxy.
• $wgProxyScriptPath (removed in 1.22) - Script used to scan for proxies.
• $wgProxyWhitelist - Proxy whitelist, list of addresses that are assumed to be non-proxy despite what the other methods might say
• $wgSecretKey - This should always be customised in LocalSettings.php
• $wgUsePrivateIPs - Whether forwarded private IPs should be accepted.

Squid

These settings configure MediaWiki when using a caching HTTP proxy server. They apply to caching using Varnish as well as Squid.

• $wgInternalServer - Internal server name as known to Squid, if different.
• $wgMaxSquidPurgeTitles (removed in 1.27) - Maximum number of titles to purge in any one client operation
• $wgSquidPurgeUseHostHeader - Whether to use a Host header in purge requests sent to the proxy servers configured in $wgSquidServers.
• $wgSquidMaxage - Cache timeout for the HTTP proxy.
• $wgSquidServers - A list of proxy servers (ips if possible) to purge on changes.
• $wgSquidServersNoPurge - Same as $wgSquidServers, except they aren't purged.
• $wgUseESI - If you run Squid3 with ESI support, enable this.
• $wgUseSquid - Enable/disable support for a caching HTTP proxy.
• $wgUseXVO (removed in 1.27) - Send X-Vary-Options header for better caching (requires patched Squid).
• $wgVaryOnXFP - Whether to add X-Forwarded-Proto to the Vary and X-Vary-Options headers for API requests and RSS/Atom feeds.

HTCP multicast purging

• $wgHTCPMulticastAddress (removed in 1.24) - Address to use for HTCP multicast purging
• $wgHTCPMulticastTTL - TTL for HTCP multicast purging
• $wgHTCPPort (removed in 1.24) - Port for HTCP multicast purging
• $wgHTCPRouting - Routing configuration for HTCP multicast purging

Extensions

• $wgAPIListModules - API list module extensions.
• $wgAPIMetaModules - API meta module extensions.
• $wgAPIModules - API module extensions.
• $wgAPIPropModules - API prop module extensions.
• $wgAuth - Authentication plugin. See AuthPlugin.phpAuthPlugin.php.
• $wgAutoloadClasses - Array mapping class names to filenames, for autoloading.
• $wgAvailableRights - A list of available rights, in addition to the ones defined by the core.
• $wgDisableInternalSearch - Disable internal search so that extensions can implement it.
• $wgExceptionHooks (removed in 1.30) - Hooks that are used for outputting exceptions.
• $wgExtensionAssetsPath - URL to extensions directory.
• $wgExtensionCredits - Global list of extension credits.
• $wgExtensionFunctions - Extension Functions
• $wgExtensionMessagesFiles (deprecated in 1.23) - Extension messages files.
• $wgExtensionDirectory - The file system path to the extensions directory.
• $wgExtensionsDirectory (removed in 1.22) - Filesystem extensions directory.
• $wgExtensionEntryPointListFiles - Array of files with list(s) of extension entry points to be used in maintenance/mergeMessageFileList.php.
• $wgExternalStores - External stores allow including content from non database sources following URL links.
• $wgHooks - Global list of hooks.
• $wgPagePropLinkInvalidations - Page property link table invalidation lists.
• $wgParserOutputHooks - Parser output hooks.
• $wgSpecialPageCacheUpdates - Additional functions to be performed with updateSpecialPages.php.
• $wgSpecialPages - A list of custom special pages.

Maintenance Scripts setting

• $wgAllowSchemaUpdates - Allow database schema updates to be executed with maintenance/update.php.
• $wgCommandLineDarkBg - For colorized maintenance script output.
• $wgCommandLineMode - Indicates whether MediaWiki is running in command-line mode. Should never be set manually!
• $wgDBadminpassword - The password for $wgDBadminuser.
• $wgDBadminuser - Database username used by the maintenance scripts.
• $wgDBtestpassword (removed in 1.22) - The password for $wgDBtestuser.
• $wgDBtestuser (removed in 1.22) - Database username that has permission to create and drop the test databases only.
• $wgHipHopBuildDirectory (removed in 1.22) - The build directory for HipHop compilation.
• $wgHipHopBuildType (removed in 1.22) - The HipHop build type.
• $wgHipHopCompilerProcs (removed in 1.22) - Number of parallel processes to use during HipHop compilation.
• $wgMaintenanceScripts (removed in 1.23) - Array for extensions to register their maintenance scripts with the system.
• $wgEnableSelenium (removed in 1.22) - Enable selenium tests
• $wgSeleniumTestConfigs (removed in 1.22) - Configuration for selenium test suites.
• $wgSeleniumConfigFile (removed in 1.22) - Selenium configuration file
• $wgUpgradeKey - Used for enabling the web upgrade script

Miscellaneous settings

• $wgAllUnicodeFixes - Whether to always convert certain Unicode sequences to modern ones regardless of the content language.
• $wgAntiLockFlags (removed in 1.25) - Anti-lock flags.
• $wgCompiledFiles (removed in 1.24) - A list of files that should be compiled into a HipHop build, in addition to those listed in $wgAutoloadClasses.
• $wgGitRepositoryViewers - Map GIT revision numbers and repository URLs to their respective gitweb URLs in Special:Version
• $wgGitBin - Path to the git binary.
• $wgExternalDiffEngine - Use external C++ diff engine (module wikidiff from the extensions package).
• $wgFixArabicUnicode - Set this to true to clean up archaic Unicode sequences in Arabic text.
• $wgFixMalayalamUnicode - Set this to true to clean up archaic Unicode sequences in Malayalam text (Default true if $wgLanguageCode = "ml").
• $wgMaxShellFileSize - Maximum file size created by shell processes under Linux, in KB.
• $wgMaxShellMemory - Maximum amount of virtual memory available to shell processes under Linux, in KB.
• $wgMaxShellTime - Maximum CPU time in seconds for shell processes under linux.
• $wgMemoryLimit - The minimum amount of memory that MediaWiki "needs"; MediaWiki will try to raise PHP's memory limit if it's below this amount.
• $wgPoolCounterConf - Configuration for processing pool control.
• $wgShellLocale - Locale for LC_CTYPE.
• $wgUseAutomaticEditSummaries - Whether MediaWiki should make automatic edit summaries.
• $wgUseTagFilter - Allow filtering by change tag in recentchanges, history, etc.
• $wgLegacySchemaConversion (deprecated) - Option to speed up the conversion step for large sites when migrating the schema from 1.4 to 1.5.
• $wgUseTrackbacks (removed in 1.19) - Whether to use trackbacks.
• $wgAjaxEditStash - Whether edits should be prepared via AJAX as users type edit summaries.

See also

• Configuration for developers: how to set and retrieve configuration variables.
• Extension registration#Configs (Your extension/skins settings): how to register new configuration variables for extensions and skins.