手册:配置设置

This page is a translated version of the page Manual:Configuration settings and the translation is 58% complete.
配置的设置从MediaWiki 1.39 版开始是以MainConfigSchema.php为基础。

这是一个基于DefaultSettings.php文件的所有支持配置设置的索引。

千万不要编辑DefaultSettings.php,而是将适当的行数复制到LocalSettings.php ,并酌情改善。

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

在1.31版之前移除的设置项不会再列在此处。 请使用搜索框來尋找手冊相關的頁面(例如Manual:$wgAllowAnonymousMinor)。
按字母顺序排序 | 按功能排序 | 分类:MediaWiki配置设置

通用的设置

全局的对象

服务器的URL及文件的路徑

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

另见皮肤路径的设置

文件及文件上传

上传必须经过特别设置,才能保证安全。

共享的上传

这些设置是为了向后兼容而保留的,新的设置见$wgForeignFileRepos ,若是你只需要对維基共享資源上的图像进行读取访问,则见$wgUseInstantCommons

MIME类型

  警告: ↑这不是一个配置设置,而是一个全局状态变量。 它应该只由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 – 一组“单独的”代理服务器,以帮助 MediaWiki 检测请求是否已被代理。
    还要在更改时发送回代理 PURGE 命令。
  • $wgForcedRawSMaxage – 原始 CSS/JavaScript 访问的默认最长期限(以秒为单位)。
  • $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 – 启用/禁用页面视图缓存。
  • $wgUseESI (在1.33版本中已弃用)If you run Squid3 with ESI support, enable this.
  • $wgUseKeyHeader (在版本1.34移除)Send the Key HTTP header for better caching.
  • $wgUsePrivateIPs – 是否接受内网X转发IP
  • $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 资源加载器 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移除) – 在HTML注释中放置整齐的警告,只适用于内部整齐。
  • $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

  • $wgEnableProfileInfo (在版本1.35移除)Controls the availability of profileinfo.php.
  • $wgMetricsTarget (在版本1.38引入) (在版本1.40移除)Output target URI for the MetricsFactory service, e.g. udp://127.0.0.1:8125.
  • $wgMetricsPrefix (在版本1.38引入) (在版本1.40移除)Service name prefix for the MetricsFactory service.
  • $wgMetricsFormat (在版本1.38引入) (在版本1.40移除)Output format for the MetricsFactory service, e.g. 'statsd'.
  • $wgProfiler Settings related to profiling.
  • $wgProfileLimit (在版本1.35移除)Only record profiling info for pages that took longer than this number of seconds to load.
  • $wgProfileOnly (在版本1.35移除) – 不要将非分析信息放入日志文件
  • $wgStatsdMetricPrefix Prefix for metric names sent to $wgStatsdServer
  • $wgStatsdSamplingRates Sampling rate for statsd metrics as an associative array of patterns and rates.
  • $wgStatsdServer Statsd伺服器的主機或主機:端口。
  • $wgStatsFormat (在版本1.40引入)Output format for the StatsFactory service, e.g. 'statsd'.
  • $wgStatsPrefix (在版本1.40引入)Service name prefix for the StatsFactory service.
  • $wgStatsTarget (在版本1.40引入)Output target URI for the StatsFactory service, e.g. udp://127.0.0.1:8125.

搜索

Edit user interface

Maintenance Scripts setting

Recent changes, new pages, watchlist and history

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 – 正常页面的“action”参数的允许值的数组。正常页面的“action”参数的允许值的数组。

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

參見