Defaultsettings.php

页面分类: Mediawiki

天下维客，你可以修改的网络知识库

DefaultSettings.php是MediaWiki系统中存放默认设置的文件，位于/includes目录中。

DefaultSettings与LocalSettings

调用顺序

在mediawiki系统中，将首先调用本文件进行通用的初始设置，然后再调用LocalSettings.php进行变量修改（以适应不同站点的需要）。

修改方式

对于需要修改的设置，请对LocalSettings.php进行设定/修改，而不是直接修改DefaultSettings.php。这样做的好处是以后升级mediawiki系统时，可以方便地进行文件替换。

DefaultSettings中的内容

通过对DefaultSettings.php的阅读，我们可以了解大量的系统设置信息，而这其中很多内容是目前缺乏详细中文介绍的。

以下是DefaultSettings.php中包含的部分设置介绍：（无版本说明时均指适用于mediawiki 1.8.x以上版本）

性能相关设置

$wgUseDatabaseMessages

使用数据库存储界面提示信息，默认为使用。本项特性可以方便界面信息的修改，见specail:allmessages页面，但是将明显增大数据库的开销，导致页面加载速度增加25-60%；memcached功能才可以有效减轻本项带来的开销。然而，关闭时会造成界面信息修改的极大不便，不建议关闭它。（欢迎补充资料）

$wgShowIPinHeader

在网页上显示匿名用户的IP。默认打开，即显示IP

$wgUseFileCache

对匿名用户访问的页面进行静态页面存储，须关闭$wgShowIPinHeader。本项可降低数据库压力，{{{1}}}（欢迎补充资料）

$wgMiserMode

关闭部分对数据库负载很大的特性，包括短页面等？实际影响不明。（欢迎补充资料）。默认未关闭这些操作。

$wgDisableQueryPages

对查询功能的控制。如果$wgMiser=true则禁止所有查询，否则只禁止一部分。

$wgDisableCounters、$wgDisableTextSearch、$wgDisableSearchContext

禁用计数器、文本搜索、全文搜索。默认未关闭上述功能。

$wgHitcounterUpdateFreq

页面访问计数器的更新频率，可用于减小服务器压力？（欢迎补充资料）默认为1，即每次访问都更新。

系统安全相关

$wgGroupPermissions、$wgRestrictionTypes、$wgAutoConfirmAge等

用户权限设置，参见mediawiki的用户权限

$wgSpamRegex = false;

用于识别spam信息的正则表达式，参见Mediawiki下对垃圾网址的处理方法。

$wgRestrictionTypes = array( 'edit', 'move' );

页面保护包含的操作类型

$wgRestrictionLevels = array( , 'autoconfirmed', 'sysop' );

设定Special:Protect页面中可被选择的permission keys集合。如果$wgAutoConfirmAge = 0，选择'autoconfirm'将允许所有注册用户操作。

$wgAutoConfirmAge = 0;

用户注册帐号之后，需要经过XX秒才能被系统认为获得'autoconfirm'群组身份。

$wgRateLimits = array(...

修改频度控制，mediawiki 1.8版本尚处于试验期。{{{1}}}（欢迎补充资料）

$wgRateLimitLog = null;

过分频繁修改的记录

$wgRateLimitsExcludedGroups = array( 'sysop', 'bureaucrat' );

不受编辑频度限制的群组

$wgAllowSpecialInclusion = true;

允许包含特殊页面，例如{{Special:Allpages}}。鉴于mediawiki的特殊页面并不能有效适应站点需求，例如设定引用条数等，建议将本设置设为false。

$wgReservedUsernames = array( 'MediaWiki default', 'Conversion script' );

禁止被注册和使用的用户名，可用于系统保留特定用户名。注意：使用时对大小写敏感，即AAA和Aaa是不同的用户，保留用户名时应留意。（同时，系统默认对首字母进行大写，allwiki会转换为Allwiki再进行注册）

$wgUseRCPatrol = true;

是否允许在最近更新中对恶意破坏进行审核标记

$wgAntivirus、$wgAntivirusSetup、$wgAntivirusRequired等

对于上传文件的病毒扫描设置。默认没有扫描操作。

搜索相关设置

$wgGoToEdit = false;

在搜索文章名称时，若文章不存在则直接转到编辑页面。默认未使用。

$wgDisableInternalSearch = false;

禁止内部基于MySQL的搜索，以便采用外部的搜索扩展

$wgSearchForwardUrl = null;

将内部搜索信息转换为外部搜索链接，例如使用Google来辅助搜索功能：

$wgSearchForwardUrl = 'http://www.google.com/search?q=$1' .
						'&domains=http://example.com' .
						'&sitesearch=http://example.com' .
						'&ie=utf-8&oe=utf-8';

$wgNoFollowLinks = true;

对外部链接增加nofollow参数，以使搜索引擎不能继续沿该链接搜索下去，从而避免spam的干扰。参见nofollow说明。

$wgNoFollowNsExceptions = array();

禁用nofollow的名字空间。这可能用于网站系统中被保护的系统页面。

$wgNamespaceRobotPolicies = array();

不同名字空间下对robot的策略设定，例如

$wgNamespaceRobotPolicies = array( NS_TALK => 'noindex' );

上传、图片相关设置

具体使用请参见mediawiki的图像功能，这里仅列出变量名称

$wgEnableUploads = false;

</dd>

$wgExtraNamespaces =
	array(100 => "Sport",
		  101 => "Sport_Talk",
		  102 => "System",
		  103 => "System_Talk"
		  );

* Number of watchers: 0
* Number of edits (article): 4
* Number of distinct authors (article): 2

$wgUploadNavigationUrl = '<a href="http://commons.wikimedia.org/wiki/Special:Upload'" class="external free" target="_blank" title="http://commons.wikimedia.org/wiki/Special:Upload'" rel="nofollow">http://commons.wikimedia.org/wiki/Special:Upload'</a>;