Mediawiki LocalSettings.php 参数指南

一、 通用设置

1、 $wgMetaNamespace meta-namespace采用的名称。

2、 $wgMetaNamespaceTalk meta-namespace的讨论页面采用的名称。通常不需要考虑该变量,也写作:$wgMetaNamespace. “_talk”。在有些语言里,可能要根据语法需要,对其进行设置。

3、 $wgServer 服务器的URL。

4、 $wgServerName 不带通信协议的服务器名称。(例如:en.wikipedia.org

5、 $wgSitename 网站名称。注意应该在 LocalSettings.php文件中改动。

6、 $wgVersion 网站正在使用的MediaWiki的版本号。

二、 路径

1、 $IP 文件系统安装路径。在DefaultSettings.php文件中不含该变量。

2、 $wgActionPaths 就各种用户操作,在地址栏内产生更为方便直观的URL路径。

3、 $wgArticlePath 产生新条目链接的URL的模板。

4、 $wgFavicon 站点favicon的URL。

5、 $wgLogo 网站logo的URL。

6、 $wgMathDirectory LaTeX数学图像所在目录的文件系统路径。

7、 $wgMathPath LaTeX数学图像所在目录的URL。

8、 $wgRedirectscrīpt Redirect.php文件的URL,该文件用于实现向低版本的兼容性。

9、 $wgscrīpt Index.php文件的URL。

10、 $wgscrīptPath wiki站点的URL。

11、 $wgStyleDirectory 皮肤目录的文件系统路径。

12、 $wgStylePath 皮肤目录的URL。

13、 $wgStyleSheetDirectory 界面风格所在目录的文件系统路径。

14、 $wgStyleSheetPath 界面风格所在目录的URL。

15、 $wgTmpDirectory 临时文件夹的URL。

16、 $wgUploadBaseUrl

17、 $wgUsePathInfo 是否采用方便直观的URL。类似:index.php/页面名称。

18、 $wgHashedUploadDirectory 设置为:true,则采用 /a/ab/foo.png式样的目录结构。

19、 $wgUploadDirectory 上载目录的文件系统路径。

20、 $wgUploadNavigationUrl 将上载功能的链接指向一个外部URL。

21、 $wgUploadPath 上载目录的URL。

三、 共享上载

1、 $wgCacheSharedUploads 在memcached中缓存共享的元数据。

2、 $wgHashedSharedUploadDirectory 是否hash共享的上载目录。如果需要多个wiki共用同一组文件,则将该值置为false。

3、 $wgSharedLatin1 如果上载文件存储空间的文件名称采用latin1字符,则将该值设置为true。

4、 $wgSharedUploadDBname 有关共享目录的元数据所在的数据库名称。如果上载文件不是来自一个wiki站点,则将该值置为false。

5、 $wgSharedUploadDirectory 共享的上载目录所在的文件系统路径。

6、 $wgSharedUploadPath 共享的上载目录所在的web 服务器的完整路径。

7、 $wgUseSharedUploads 如果在本地的文件上载空间中找不到某个给定文件(例如:[[Image:…]]、[[Media:…]]等),是否在共享的上载空间内继续搜索。

8、 $wgFetchCommonsDescrīptions 设置为“true”,则可以整合储存在commonswiki中的媒体文件介绍。

四、 Email 设置

1、 $wgEmergencyContact 站点管理员的email地址。

2、 $wgEnableEmail 设置为“true”,启用email的各项基本功能,例如:用户遗忘密码时,发出提示信息等。

3、 $wgEnableUserEmail 设置为“true”,启用用户之间的email功能。

4、 $wgPasswordSender 用于发送密码提示信息的邮件地址。

5、 $wgSMTP 采用一个直接的(authenticated 或者需要密码验证的)SMTP服务器连接。

五、 数据库设置

1、 $wgDBconnection

2、 $wgDBerrorLog 记录MySQL错误的日志文件。

3、 $wgDBminWordLen 通常情况下,如果某个单词长度小于该变量,MySQL将会忽略这个不会返回任何结果的(搜索)单词。(参见mysql系统变量ft_min_word_len)

4、 $wgDBmysql4 设置为:true,则可以应用高级全文搜索功能。

5、 $wgDBname 数据库名称。

6、 $wgDBpassword 数据库用户密码。

7、 $wgDBport 数据库端口。

8、 $wgDBprefix 表名称前缀。

9、 $wgDBschema 在一些数据库中,该值允许针对网站数据采用分离的逻辑名称空间。

10、 $wgDBserver 数据库主机名称或者ip地址。

11、 $wgDBservers 数据库负载平衡器。一个记录数据库信息结构的二维数组,设置为false,则采用单个服务器的信息结构。

12、 $wgDBtransactions 如果采用InnoDB表,将该值设置为:true。

13、 $wgDBtype 数据库类型。

14、 $wgDBuser 数据库用户名称。

15、 $wgLocalDatabases 可以用一个开发者帐户,对安装在本网站内的其他的wiki站点实施管理。

16、 $wgMasterWaitTimeout Slave跟踪上master需要花费的时间。

17、 $wgSearchType 数据库搜索类型。

18、 $wgSqlLogFile

19、 $wgSqlTimeout

六、 共享数据库设置

1、 $wgSharedDB 多个wiki站点共享的数据库名称。

七、 系统管理员SQL查询注意:管理员通过Special:Asksql进行查询时,将会用到以下设置。警告:如果配置不当,会给系统带来不安全因素。

1、 $wgAllowSysopQueries 允许管理员进行查询操作。

2、 $wgDBsqlpassword 数据库用户密码。

3、 $wgDBsqluser 进行查询操作的SQL数据库用户。

八、 memcached 的设置参见:docs/memcached.doc文档。

1、 $wgLinkCacheMemcached 采用对象缓存设置的缓存链接。(缓存设置包括memcache, Turck MMCache, eAccelerator 等)。

2、 $wgMemCachedDebug 如果服务器不工作,在Setup.php中将该值设置为false。

3、 $wgMemCachedServers

4、 $wgSessionsInMemcached

5、 $wgUseEAccelShm 如果wiki站点运行在专用服务器上,可以借此实现持久缓存。

6、 $wgUseMemCached 采用$wgMemCachedServers中的服务器设置,运行memcache。

7、 $wgUseTurckShm 采用Turck MMCache 共享内存。

8、 $wgUseMemCached 已经不再使用了,取代的是: “$wgMainCacheType=CACHE_MEMCACHED;”

九、 本地化配置

1、 $wgAmericanDates 在英文界面中,按照“May 12”而不是“12 May”的格式输出日期。

2、 $wgDisableLangConversion 是否启用语言变量转换。

3、 $wgDocType 在声明中采用的文档类型。

4、 $wgDTD

5、 $wgEditEncoding

6、 $wgForceUIMsgAsContentMsg

7、 $wgInputEncoding 输入文本编码方式:UTF-8。

8、 $wgInterwikiMagic 将语言链接作为magic connectors,而不是在线链接。

9、 $wgLanguageCode 站点语言,应该属于./language/Languages(.*).php文件中的某一个。

10、 $wgLanguageFile dumpMessages.php文件产生的语言文件的名称。

11、 $wgLegacyEncoding 在调用没有做utf-8标记的旧的更改时,需要将该变量设置为:’ISO-8859-1’, 完成字符集转换。

12、 $wgLocaltimezone 调整服务器输出时间的时区。

13、 $wgMimeType 在头部信息的“Content-Type”中定义的类型。

14、 $wgMsgCacheExpiry 一个消息在缓存内滞留的时限(单位为秒)。

15、 $wgOutputEncoding 输出文本编码方式:UTF-8。

16、 $wgPartialMessageCache

17、 $wgTranslateNumerals 针对那些在网页界面中采用印度和阿拉伯当地的数字表示方法,而不是(0-9)数字格式的用户。

18、 $wgUseDatabaseMessages 采用MediaWiki: namespace完成转换。如果不安装memcached,此举会将网站上载时间延长25-60%。

19、 $wgUseDynamicDates 启用该项功能,能够(自动?)改写页面文档中的日期和时间。注意:对于大多数语言来讲,改写后的日期格式不正常。

20、 $wgUseLatin1 启用ISO-8859-1兼容性模式。

21、 $wgUseZhdaemon 是否采用zhdaemon进行中文文字处理。Zhdaemon仍在开发阶段,所以除了测测,一般不会用到该功能。

22、 $wgZhdaemonHost Zhdaemon所在的主机。仅在$wgUseZhdaemon设置有效以后方可启用。

23、 $wgZhdaemonPort Zhdaemon所在的主机端口。

十、调试/日志记录

1、$wgDebugComments

2、$wgDebugDumpSql

3、$wgDebugLogFile 调试日志的文件名称,不启用时,该值为空。另有wfDebug() 变量添加到该文件中。

4、$wgDebugRawPage 避免由于CSS外泄,导致调试内容遭到覆盖。

5、$wgDebugRedirects

6、$wgLogQueries

7、$wgShowSQLErrors 是否显示:“很抱歉,出现了一个数据库错误”页面。在调试过程中显示错误提示信息。但是,网站攻击者也可能从中受益。

十一、Profiling

1、$wgDebugFunctionEntry 每次调用wfProfileIn/wfProfileOut函数时,均输出调试信息。

2、$wgDebugProfiling 检测没有响应(无法匹配)的wfProfileIn/wfProfileOut函数调用。

3、$wgDebugSquid 来自SquidUpdate.php文件的大量调试输出信息。

4、$wgProfileCallTree 设置为:true,不会报告每一个函数的调用状态,而是打印输出一个有关所有函数调用的粗略的树形结构。

5、$wgProfileLimit 只有页面长度超过该设定值时,才记录其profling信息。

6、$wgProfileOnly 不要将非profiling信息写入日志文件。

7、$wgProfileSampleRate 开启profiling以后,每隔n次请求,进行一次profile。

8、$wgProfileToCommentUser 仅就某一个具体用户,将profiling信息添加在输出文件的HTML代码当中。

9、$wgProfileToDatabase 将profile中的sums信息写入数据库的”profiling”表中。

10、$wgProfiling 启用该选项,在调试日志中采用更为详尽的时间信息。

十二、网站定制以下是应用于整个站点的外观设置。

1、$wgAllowUserCss 是否允许使用用户自定义的CSS。能够增添雅致的个性化风格,但是会给用户和服务器带来不安全因素。

2、$wgAllowUserJs 是否允许使用用户的Javascrīpt页面。能够增添雅致的个性化风格,但是会给用户和服务器带来不安全因素。

3、$wgDefaultUserOptions 在该数组内增添新的元素,将会覆盖匿名访客和新注册用户的个性化设置空间内的语言全局变量。

4、$wgExtraSubtitle 显示在每个页面标题下的副题。

5、$wgNavigationLinks 页面旁侧的导航链接。

6、$wgNoFollowLinks 设置为:true,给wiki文档中的外部链接设置rel=nofollow 属性。

7、$wgSiteNotice 在每个页面顶端显示其内容。

8、$wgSiteSupportPage 用户得到捐助的联系页面。

9、$wgUrlProtocols 定义mediawiki分析程序支持和可以转换为HTML代码的通信协议。

10、$wgUseSiteCss 使用站点提供的CSS。

11、$wgUseSiteJs 使用站点提供的Javascrīpt页面。

十三、名称空间名称空间含以下各项:

-2 Media: -1 Special: 0 Template: 1 Talk: 2 User: 3 User_talk: 4 Test: 5 Test_talk: 6 Image: 7 Image_talk: 8 MediaWiki: 9 MediaWiki_talk: 10 Template: 11 Template_talk: 12 Help: 13 Help_talk: 14 Category: 15 Category_talk:

1、$wgExtraNamespaces 新增添的名称空间。如果Language.php和Namespace.php文件里定义的名称空间不够用,可以在此增添。

2、$wgNamespacesToBeSearchedDefault 应该在那些名称空间内进行搜索?

3、$wgNamespacesWithSubpages 那些名称空间可以包含子页面?

十四、皮肤

1、$wgDefaultSkin 站点默认皮肤。

2、$wgSkipSkin 在可获取的皮肤列表中不出现该皮肤选项。

3、$wgSkipSkins 数组变量,作用同$wgSkipSkin。

十五、分类

1、$wgCategoryMagicGallery 在分类页面内,以缩略图的方式显示属于该分类的图像,而不是以条目的形式将其罗列出来。

2、$wgUseCategoryBrowser 禁用实验性的类似于dmoz的按分类浏览网页的方式。例如:Encyclopedia>Music>Style of Music>Jazz

3、$wgUseCategoryMagic 是否应当启用分类的伪名称空间?(在一个页面上添加[[Categoryog]],是否可以在“Dog”分类中包含该页面?)

十七、缓存

1、$wgCacheEpoch 置为当前时间,以取消全部已经缓存的页面(包括客户端和服务器端)。

2、$wgCachePages 允许客户端缓存页面。

3、$wgEnableParserCache 将语法分析过的页面存贮于缓存(objectcache 表,turck,或者memcached)内,以加快有着同样操作要求的其他用户打开该页面的速度。

4、$wgFileCacheDirectory

5、$wgImageHtmlCacheExpiry 设置为数秒钟,缓存跟某幅图像相关的HTML代码。

6、$wgUseFileCache 给未登录用户缓存静态页面,减缓公网上数据库的操作负荷。

7、$wgUseGzip 采用GZip存储缓存内的页面。要求PHP启用zlib支持。

8、$wgUseWatchlistCache 每隔大约一小时,产生一个监视列表。

9、$wgWLCacheTimeout 上面提到的大约一小时时间。

10、$wgMainCacheType 代替$wgUseMemCached变量。类型信息参见Defines.php。

十八、Persistent链接缓存

1、$wgCompressedPersistentLC 采用gz压缩的blobs变量。

2、$wgEnablePersistentLC 已经停止使用。

十九、Interwiki

1、$wgInterwikiExpiry interwiki表的缓存有效期。

2、$wgLocalInterwiki 本wiki 站点的Interwiki前缀。应该在LocalSettings.php中加以修改。