配置 MediaWiki 短路徑方法

我所在的前端團隊使用 MediaWiki 作為文檔庫. 一直以來需要通過 IP 訪問服務, 今天總算綁定了域名: wiki.aliluna.com. 終于不用將 Wiki 存在收藏夾了. 綁定域名后發現 MediaWiki 的路徑很是復雜, 默認有以下兩種形式.

http://wiki.aliluna.com/mediawiki/index.php/文章標題
http://wiki.aliluna.com/mediawiki/index.php?title=文章標題

從目錄結構來看, 可以認為 Wiki 的所有頁面都放在一個目錄里面, 再通過鏈接互相橋接. 默認的路徑顯然過于臃腫. 其實 MediaWiki 短路徑, 如下即可.

http://wiki.aliluna.com/文章標題

MediaWiki 官方為這樣臃腫的路徑方式作出了解釋, 認為這樣的路徑結構適合所有主機環境, 因為你不知道哪一天會遷移 Wiki, 但新的主機環境業務不能使用短路徑. 但我們自己搭建的服務器, 怎么可能出現這樣的情況? 再說, 不支持核心功能的主機, 不買也罷. 所以, 還是使用短路徑吧, 好記...

使用 MediaWiki 短路徑的方法

為了使用了簡化 URL, 我做了一些修改, 下面會逐步說明.

1. 修改 MediaWiki 的本地設定文件

打開 LocalSettings.php 修改配置如下.

1

2

3

$wgScriptPath = "";

$wgArticlePath = '/$1';

$wgUsePathInfo = false;

2. 添加 .htaccess 配置

上一步已經將訪問 URL 改為了短路徑形式, 但還不能正常訪問, 因為 Web 服務器不能通過那個路徑找到網頁資源. 所以我們需要通過 .htaccess 重寫規則. 在 MediaWiki 的根目錄新建 .htaccess, 文件內容如下.

1

2

3

4

5

6

RewriteEngine on

RewriteCond %{REQUEST_FILENAME} !-f

RewriteCond %{REQUEST_FILENAME} !-d

RewriteRule ^(.+)$ index.php?title=$1 [L,QSA]

如果你發現 .htaccess 沒有生效, 請確認兩處.

• 打開 httpd.conf, 將 LoadModule rewrite_module /usr/lib/apache2/modules/mod_rewrite.so 前的 # 號去除; 如果 httpd.conf 內不包含該語句, 請自行添加. (不同的服務器環境中 mod_rewrite.so 文件路徑可能不一樣.)
• 打開 Apache 配置文件 (一般是 httpd.conf 文件, Ubuntu 是 apache2.conf 文件) 或者 VirtualHost 配置文件, 將對應目錄下 AllowOverride 的值改為 All．

操作后重啟 Apache 服務器即可.