帮助:DefaultSettings.php

This is an index of all supported configuration options based on the DefaultSettings.php file. Never edit DefaultSettings; copy appropriate lines to LocalSettings.php instead and amend them as appropriate. Template: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功能才可以有效減輕本項帶來的開銷。然而，關閉時會造成界面信息修改的極大不便，Template:?

$wgShowIPinHeader

在網頁上顯示匿名用戶的IP。默認打開，即在頁面上頭顯示用戶的 IP。

$wgUseFileCache

對匿名用戶訪問的頁面進行靜態頁面存儲，須關閉$wgShowIPinHeader。本項可減少數據庫的存取次數，Template:?

$wgMiserMode

關閉部分對數據庫負載很大的特性，Template:?。默認未關閉這些操作。

$wgDisableQueryPages

對查詢功能的控制。如果$wgMiser=true則禁止所有查詢，否則只禁止一部分。

$wgDisableCounters、$wgDisableTextSearch、$wgDisableSearchContext

禁用計數器、文本搜索、全文搜索。默認未關閉上述功能。

$wgHitcounterUpdateFreq

頁面訪問計數器的更新頻率，Template:?默認為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版本尚處於試驗期。Template:?

$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;

$wgUseImageResize = false;

$wgMaxUploadSize

上傳文件的最大體積限制，默認為100M。Template:?

該參數還受到了 php.ini 中 upload_max_filesize 的參數影響。（我本機是wamp，php.ini位於 安裝目錄\Apache2\bin下）

$wgHashedSharedUploadDirectory

上傳文件是否採用Hash目錄方式（images/a/aa/filename）存放。默認採用Hash方式，這樣有助於網站安全，避免惡意使用者猜測到文件的具體存放位置。如希望只存在images目錄下，本選項應設為false。

$wgFileExtensions = array( 'png', 'gif', 'jpg', 'jpeg' );

$wgFileBlacklist

$wgUploadSizeWarning = 150 * 1024;

上傳文件的大小超過此值時會產生警告

$wgAllowCopyUploads = false;

是否允許指定外部網站圖片URL網址來上傳文件。默認關閉。

$wgImageLimits = array (...

圖像描述頁中使用的圖片大小，Template:?

$wgThumbLimits = array(...

限定圖像縮略圖的寬度，以節省磁盤佔用。

$wgCategoryMagicGallery = true;

在分類頁面中以畫廊形式展示該分類下的圖片頁面，而不是採用文章鏈接形式展示

$wgCategoryPagingLimit = 200;

分類頁面中每頁最多展示的項數

$wgDjvuToXML、$wgDjvuRenderer、$wgDjvuPostProcessor等

Djvu圖像格式支持。目前應用很少，一般可不理會。

$wgThumbnailScriptPath = false;

$wgSharedThumbnailScriptPath = false;

$wgUseImageMagick = false;

$wgImageMagickConvertCommand = '/usr/bin/convert';

$wgCustomConvertCommand = false;

$wgSVGConverters = array(...

$wgSVGConverter = 'ImageMagick';

$wgSVGConverterPath = ;

$wgSVGMaxSize = 1024;

$wgMaxImageArea = 1.25e7;

$wgGenerateThumbnailOnParse = true;

[编辑] 名字空間相關

$wgNamespacesWithSubpages

允許建立子頁面的名字空間

$wgNamespacesToBeSearchedDefault

進行檢索時默認包含的名字空間

$wgExtraNamespaces = NULL;

擴充名字空間，舉例如下：

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

注意：一旦設定又取消擴充的名字空間，則該名字空間下建立的文章將無法繼續被訪問。但對名字空間進行改名則沒問題，僅僅是採用新的名字空間來訪問相應文章而已。

用戶自定義的名字空間應從100開始，避免與系統內定的名字空間衝突。正文頁面使用偶數，討論頁使用奇數。

$wgSitename = 'MediaWiki';

站點名稱。本項在LocalSettings.php中被重新定義。

$wgMetaNamespace = false;

project namespace的名稱。若保持false狀態，將使用 $wgSitename 來代替。

$wgMetaNamespaceTalk = false;

project talk namespace的名稱。若保持false狀態，則將使用由project namespace衍生出來的名稱。本設定僅在少量特殊語種中因為語法原因而進行修改，否則一般無需調整。

[编辑] 頁面提示相關

$wgSiteNotice

每個頁面中都會顯示的提示信息，指定字串將出現於文章標題上方。

$wgMaxCredits = 0;

文章貢獻者的提示數量。修改為非零數值N後就在文章底部顯示N個貢獻者信息。

【版權相關內容】

$wgRightsPage

$wgRightsUrl

$wgRightsText

$wgRightsIcon

$wgCopyrightIcon

【界面js/CSS定製相關】

$wgAllowUserJs = false;

$wgAllowUserCss = false;

$wgUseSiteJs = true;

$wgUseSiteCss = true;

$wgAllowPageInfo = false;

對頁面進行action=info操作，可以顯示如下信息。由於開銷比較大，默認關閉此特性。

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

$wgSiteSupportPage

網站捐助頁面的標題。在使用數據庫信息時，應通過mediawiki:sitesupport-url項來修改。

$wgUseCategoryBrowser

一個處於測試期的分類功能，可以在分類信息內顯示更多的層級關聯信息。默認關閉。

$wgExtraSubtitle

Template:?

[编辑] 文章編輯相關

$wgCapitalLinks = true;

文章名稱若為英文字母，則自動轉換為大寫。

$wgLegalTitleChars

文章標題中的允許字符。標題中禁止出現「[]{}|#」符號，「%?+」是否正常起作用則隨服務器環境設置而有所不同。

$wgMaxNameChars

用戶名的最大字節數

$wgMaxArticleSize

文章最長KB數。默認為2048KB。

$wgUserHtml = true;

允許在wiki文本中使用部分比較安全的html代碼。參見mediawiki允許的html代碼。

$wgRawHtml = false;

允許使用所有html代碼。這會導致很大的潛在危險，因為可能有人利用此特性發佈惡意代碼或對網站進行攻擊。默認不開放全部html代碼的權限。

$wgUseTidy = false;

使用Tidy對用於輸入的html代碼進行語法檢查/修正。若使用此特性時還要對DefaultSettings.php中更多相關變量進行設置。

$wgMaxTocLevel = 999;

目錄中的最大縮進層數

$wgExternalDiffEngine = false;

是否使用外部的版本比較工具

$wgUseETag

Template:?作用不明

[编辑] 雜類設置

$wgDefaultUserOptions

用戶默認參數設置，包括編輯區大小設定、最近更新的範圍等

$wgLocaltimezone = null;

$wgLocalTZoffset = null;

時間信息設定，參見mediawiki的時區設置。

$wgUseTrackbacks = false;

是否打開trackback功能。如果打開，則會在左側工具欄中出現Trackback鏈接，Template:?

$wgUseExternalEditor = true;

啟用外部文本編輯器。參見 http://meta.wikimedia.org/wiki/Help:External_editors

$wgSortSpecialPages = true;

Special:Specialpages裡面是否對特殊頁面進行排序

$wgDisableLangConversion = false;

是否禁止語言變種轉換，例如繁體中文/簡體中文的轉換。

Cache/Squid、Cookie/Session、Interwiki、Debug/Profiling/Log、Proxy防範、系統內存/文件大小、編碼相關設置

複雜功能，介紹從略

路徑信息、電子郵件信息、數據庫帳號信息

這些內容在LocalSettings.php中被重新設定，此處介紹從略。

[编辑] 多wiki站點、Interwiki相關設置

$wgUseSharedUploads、wgSharedDB等

多wiki站點共享上傳文件、共享數據庫等的設置

$wgUploadNavigationUrl = false;

指定外部圖像服務器進行上傳的網址，例如維基百科使用如下設置上傳到公用資源服務器：

$wgUploadNavigationUrl = 'http://commons.wikimedia.org/wiki/Special:Upload';

$wgRepositoryBaseUrl="http://commons.wikimedia.org/wiki/Image

";

指定資源服務器的Base URL，Template:?

$wgInterwikiMagic = true;

Treat language links as magic connectors, not inline links

$wgHideInterlanguageLinks = false;

側欄中是否隱藏跨語言鏈接

[编辑] Ajax相關設置

$wgUseAjax = false;

是否使用Ajax特性，Template:?

$wgAjaxSearch = false;

是否打開搜索條的自動建議提示功能，Template:?

$wgAllowDisplayTitle = false ;

是否允許DISPLAYTITLE在顯示中改變文章標題，Template:?

[编辑] 參考資料

• mediawiki的系統設置
• LocalSettings.php
• mediawiki的系統界面