手册:配置设定

This page is a translated version of the page Manual:Configuration settings and the translation is 53% complete.
Starting with MediaWiki 1.39 the configuration settings are based on MainConfigSchema.php.

这是 DefaultSettings.php 支持的所有配置设定的帮助。

不要编辑DefaultSettings.php;将相应的行复制到LocalSettings.php 并进行所需的修改。

如果在这里找不到某一配置项,可以看看在DefaultSettings.php中有没有定义。 在那里变量都应该给出了一些说明。

在1.31以前移除的配置项不会再列在此处。 请在搜索框中搜索相应的手册页面(例如Manual:$wgAllowAnonymousMinor)。
按字母顺序排序 | 按功能排序 | 分类:MediaWiki配置设置

通用设置

全局对象

服务器URL及文件路徑

另见文件/图像上传路径配置

另见皮肤路径配置

文件及文件上传

Uploads have to be specially set up to be secure.

Shared uploads

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

MIME类型

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

另见: Manual:Mime type detection

图片

另见: 手册:配置文件上传

DjVu

EXIF

  • $wgShowEXIF Show EXIF data at the end of file description pages.
  • $wgUpdateCompatibleMetadata Whether to automatically update the img_metadata field if it is outdated but compatible with the current version.

ImageMagick

SVG

缩略图设置

杀毒

邮件设置

See also User Access: $wgEmailConfirmToEdit

电子邮件通知(Enotif)设置

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

数据库设置

负载均衡设置

MySQL特定配置

  • $wgDBmysql5 (在版本1.33移除)Set to true to set MySQL connection into UTF-8 encoding (experimental)
  • $wgDBTableOptions – 在安装及更新过程中使用的MySQL表选项。
  • $wgSQLMode Value for the MySQL sql_mode parameter

PostgreSQL特定配置

  • $wgDBport – 数据库端口。只用于PostgreSQL。

SQLite特定配置

共享数据库设置

扩展字段

  • $wgExtPGNewFields (在版本1.36移除)Extension defined fields to be added to existing tables
  • $wgExtNewTables (在版本1.36移除)Extension Defined tables to be added on schema change
  • $wgExtNewFields (在版本1.36移除) – 定义添加到现有表格字段的扩展
  • $wgExtNewIndexes (在版本1.36移除)Extension defined indexes to be added to existing tables
  • $wgExtPGAlteredFields (在版本1.36移除)Extension defined columns to be altered in tables
  • $wgExtModifiedFields (在版本1.36移除)Extension defined fields to change existing tables

内容处理器和存储

性能技巧和限制

缓存

主页面: Manual:Caching
See: Interwiki for Interwiki cache settings.

文件缓存

服务器端文件缓存的设置。

消息缓存

侧边栏缓存

解析器缓存

Memcached 设置

配置 Memcached 基于内存的对象存储的设置(如果您正在使用它的话),docs/memcached.md 可以获取更多详细信息。

WAN cache

HTTP 代理 (CDN) 设置

这些设置在使用带有缓存的HTTP 代理服务器时配置MediaWiki。 它们适用于使用 caching using VarnishSquid的情况下进行缓存。

  • $wgCdnMatchParameterOrder (在版本1.39引入)Indicates if should take query parameters order on incoming requests into account for CDN caching
  • $wgCdnMaxageLagged Cache timeout for the CDN when DB replica lag is high
  • $wgCdnMaxageStale Cache timeout in seconds when delivering a stale ParserCache response due to PoolCounter contention.
  • $wgCdnMaxageSubstitute Cache timeout for the CDN when a response is known to be wrong or incomplete (due to load)
  • $wgCdnMaxAge Cache TTL for the CDN sent as s-maxage (without ESI) or Surrogate-Control (with ESI).
  • $wgCdnReboundPurgeDelay Secondary delayed purges of URLs
  • $wgCdnServersNoPurge Same as $wgCdnServers , except that MW has no methods to send HTTP PURGE to an origin part of the configured ranges
  • $wgCdnServers An array of individual proxy servers to help MediaWiki detect if the request has been proxied.
    But also to send back to the proxy PURGE commands on changes.
  • $wgForcedRawSMaxage Default maximum age (in seconds) for raw CSS/JavaScript accesses.
  • $wgInternalServer – Squid已知的内部服务器名称(如果不同于$wgServer )。
  • $wgLoggedOutMaxAge (在版本1.38移除) – 对于已登出用户,以最大寿命发送的用户代理缓存TTL。
  • $wgSquidMaxage (在版本1.35移除)Cache timeout for the squid.
  • $wgSquidPurgeUseHostHeader (在1.33版本中已弃用)Whether to use a Host header in purge requests sent to the proxy servers configured in $wgSquidServers.
  • $wgSquidServersNoPurge (在版本1.35移除)Same as $wgSquidServers , except that MW has no methods to send HTTP PURGE to an origin part of the configured ranges
  • $wgSquidServers (在版本1.35移除)An array of individual proxy servers to help MediaWiki detect if the request has been proxied.
    But also to send back to the proxy PURGE commands on changes.
  • $wgUseCdn Enable/disable page view caching.
  • $wgUseESI (在1.33版本中已弃用)If you run Squid3 with ESI support, enable this.
  • $wgUseKeyHeader (在版本1.34移除)Send the Key HTTP header for better caching.
  • $wgUsePrivateIPs Whether private X-Forwarded-For IPs should be accepted
  • $wgUseSquid (在版本1.35移除) – 启用/禁用Squid。
  • $wgVaryOnXFP Whether to add X-Forwarded-Proto to the Vary header for API requests and RSS/Atom feeds.

HTCP 组播清理

语言、区域和字符编码设置

时区设置

特定语言的配置

英语
  • $wgAmericanDates Use 'mdy' instead of 'dmy' as the default date format, e.g. 'May 12' instead of '12 May'.
阿拉伯语/印地语
  • $wgTranslateNumerals For Hindi, Arabic, and other languages with their own numeral systems, use local numerals instead of Western style (0-9) numerals in some areas of the interface.

输出格式和皮肤设置

输出

以下设置不再在受支持的 MediaWiki 版本中使用,但为了向后兼容仍然存在。

皮肤

  • $wgDefaultSkin – 新用户默认皮肤。
  • $wgFallbackSkin Fallback skin used when the skin defined by $wgDefaultSkin can't be found.
  • $wgFooterIcons Abstract list of footer icons for skins. It replaces the old copyrightico and poweredbyico code, which until MediaWiki 1.27 could be influenced with $wgCopyrightIcon
  • $wgSkinMetaTags (在版本1.36引入)An array of open graph tags which should be added by all skins.
  • $wgSkipSkins Specify the name of skins that should not be presented in the list of available skins.
  • $wgSkipSkin (在版本1.35移除)Specify the name of a skin that should not be presented in the list of available skins.
  • $wgUseCombinedLoginLink Login / create account link behavior when it's possible for anonymous users to create an account.
  • $wgVectorUseIconWatch – 观看和取消观看为星形图标,而不是链接(仅适用于Vector皮肤界面)。
  • $wgVectorUseSimpleSearch – Vector皮肤下搜索表单的外观。

资源加载器

See ResourceLoader for more information.

页面标题及重定向

命名空间

移动端支持

Interwiki links and sites

Interwiki cache

更多信息另见interwiki cache

Parser

HTML

  • $wgRawHtml – 允许原始没有经过检查的HTML放在‎<html>...‎</html>里。

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.
  • $wgDebugTidy (在版本1.33移除)Put tidy warnings in HTML comments, only works for internal tidy.
  • $wgTidyBin (在版本1.33移除) – 应该设置为整齐的二进制文件的路径。
  • $wgTidyConf (在版本1.33移除)Should be set to the path of the tidy configuration file.
  • $wgTidyInternal (在版本1.33移除)Controls the use of the tidy extension to use an in-process tidy library instead of spawning a separate program.
  • $wgTidyOpts (在版本1.33移除)Options passed to tidy on the command line.
  • $wgUseTidy (在版本1.33移除) – 使用Tidy确保输出的HTML正常。
  • $wgValidateAllHtml (在版本1.31移除)Validate the overall output using tidy and refuse to display the page if it's not valid.
See also: Manual:Build Tidy from source .

Statistics and content analysis

  • $wgActiveUserDays – 在一段时间中有编辑的用户将被视为活跃用户。
  • $wgArticleCountMethod – 方法用于确定内容名称空间中的页是否应算作有效的內容頁面(條目)。
  • $wgDisableCounters (在版本1.35移除) – 禁用页面预览次数计数器。
  • $wgExperiencedUserEdits Determines the number of edits needed to qualify at the "Experienced user" level.
  • $wgExperiencedUserMemberSince Determines the number of days needed since account creation to qualify at the "Experienced user" level.
  • $wgLearnerEdits Determines the number of edits needed to qualify at the "Learner" experience level.
  • $wgLearnerMemberSince Determines the number of days needed since account creation to qualify at the "Learner" experience level.
  • $wgManualRevertSearchRadius (在版本1.36引入)Maximum number of revisions of a page that will be checked against every new edit made to determine whether the edit was a manual revert.
  • $wgRevertedTagMaxDepth (在版本1.36引入)Maximum depth (revision count) of reverts that will have their reverted edits marked with the mw-reverted change tag.
  • $wgSiteStatsAsyncFactor (在版本1.34移除)Sets how often site statistics should be updated.

User accounts, authentication

Authentication

User rights, access control and monitoring

访问

Blocking/banning, and some other related settings.

See 手册:阻止访问 for more methods and settings concerning access. See also 手册:用户权限 for more information about $wgGroupPermissions, $wgAddGroups, $wgRemoveGroups, etc.

See User Access for User Access settings.

Security

Cookies

Profiling, testing and debugging

Debug

See also: 手册:如何调试

Profiling

搜索

Edit user interface

Maintenance Scripts setting

Recent changes, new pages, watchlist and history

See also Help:近期變更 and $wgDefaultUserOptions

Feed

  • $wgFeed Toggle syndication feeds (RSS, Atom e.g. Recentchanges, Newpages) on and off.
  • $wgAdvertisedFeedTypes Feed types that 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 e.g. Recentchanges, Newpages.
  • $wgOverrideSiteFeed Override the site's default rss/atom feed that appears on every page.

版权

Import/Export

Extensions

Category

Logging

Special pages

Actions

  • $wgActions Array of allowed values for the "action" parameter for normal pages.

Robot policies

Ajax, Action API and REST API

Ajax

API

Shell and process control

HTTP client

Jobs

Site customization

Frontend

  • $wgUsejQueryThree (在版本1.31移除)Whether to use jQuery 3 (with jQuery Migrate) instead of jQuery 1.

Wiki farm

Miscellaneous settings

參見