MediaWiki
MediaWiki是一個免費、開源的維基軟體,用 PHP 寫成;原本是為維基百科開發的。它也給 archwiki 提供了幫助。(詳情查看 Special:Version 和 GitHub repository)。
安裝[編輯 | 編輯原始碼]
為了運行 MediaWiki 你需要三個組件:
- mediawiki包 包,PHP 會作為它的依賴安裝
- 一個網站伺服器– 例如 Apache HTTP Server、nginx 和 lighttpd
- 一個資料庫系統 – MariaDB、PostgreSQL、SQLite 或 MySQL
如果要在 XAMPP 上安裝 MediaWiki,參見 mw:Manual:Installing MediaWiki on XAMPP
配置[編輯 | 編輯原始碼]
實現一個可用的 MediaWiki 配置的步驟包括編輯 PHP 設置和添加 MediaWiki 配置片段。
PHP[編輯 | 編輯原始碼]
MediaWiki 需要 iconv
和 intl
插件,所以需要把 /etc/php/php.ini
裡面的 extension=iconv
和 extension=intl
取消注釋。
可選插件:
- 為了渲染縮略圖,安裝 ImageMagick 或者 php-gd包(二選一)。如果安裝的是後者,需要取消注釋
extension=gd
。
啟用你的資料庫管理系統的 API:
- 如果是 MariaDB,取消注釋
extension=mysqli
。 - 如果是 PostgreSQL,安裝 php-pgsql包 並取消注釋
extension=pgsql
。 - 如果是 SQLite,安裝 php-sqlite包 並取消注釋
extension=pdo_sqlite
。
其次,調整會話處理方式,否則可能會在尋找 session.save_path
路徑時遇到嚴重錯誤(PHP Fatal error: session_start(): Failed to initialize storage module[...]
)。/var/lib/php/sessions
或 /tmp/
路徑是個不錯的選擇。
/etc/php/php.ini
session.save_path = "/var/lib/php/sessions"
如果那個目錄不存在,你要手動創建它,並更改權限:
# mkdir -p /var/lib/php/sessions/ # chown http:http /var/lib/php/sessions # chmod go-rwx /var/lib/php/sessions
如果你使用了 PHP's open_basedir 並想允許文件上傳,你需要把 /var/lib/mediawiki/
添加到裡面去 (mediawiki包 為 images/
創建了指向 /var/lib/mediawiki/
的符號連結)。
網站伺服器[編輯 | 編輯原始碼]
Apache[編輯 | 編輯原始碼]
按照 Apache HTTP Server#PHP 配置 PHP。
複製 /etc/webapps/mediawiki/apache.example.conf
到 /etc/httpd/conf/extra/mediawiki.conf
並按需要修改它。
添加下面這一行到 /etc/httpd/conf/httpd.conf
:
Include conf/extra/mediawiki.conf
重啟 httpd.service
。
/etc/webapps/mediawiki/apache.example.conf
會覆蓋 PHP 的 open_basedir 設置,可能會和其他頁面產生衝突。 可以通過把以 php_admin_value
開頭的行移到 <Directory>
標籤之間來避免這個問題。而如果你運行了多個依賴同一個 server 的應用,你可以把這個值添加到 /etc/php/php.ini
裡的 open_basedir 裡,而不僅僅是放在 /etc/httpd/conf/extra/mediawiki.conf
裡。Nginx[編輯 | 編輯原始碼]
對於 Nginx,請創建這樣的一個文件:
/etc/nginx/mediawiki.conf
location / { index index.php; try_files $uri $uri/ @mediawiki; } location @mediawiki { rewrite ^/(.*)$ /index.php; } location ~ \.php?$ { include /etc/nginx/fastcgi_params; fastcgi_pass unix:/var/run/php-fpm/php-fpm.sock; fastcgi_index index.php; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; try_files $uri @mediawiki; } location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg)$ { try_files $uri /index.php; expires max; log_not_found off; } # Restrictions based on the .htaccess files location ~ ^/(cache|includes|maintenance|languages|serialized|tests|images/deleted)/ { deny all; } location ~ ^/(bin|docs|extensions|includes|maintenance|mw-config|resources|serialized|tests)/ { internal; } location ^~ /images/ { try_files $uri /index.php; } location ~ /\. { access_log off; log_not_found off; deny all; } location /rest.php { try_files $uri $uri/ /rest.php?$args; }
請確保已經安裝了 php-fpm包 並啟動了 php-fpm.service
。
在/etc/nginx/nginx.conf
添加一個 server 塊,類似這樣的:
/etc/nginx/nginx.conf
server { listen 80; server_name mediawiki; root /usr/share/webapps/mediawiki; index index.php; charset utf-8; # For correct file uploads client_max_body_size 100m; # Equal or more than upload_max_filesize in /etc/php/php.ini client_body_timeout 60; include mediawiki.conf; }
最後,restart nginx.service
和 php-fpm.service
。
Lighttpd[編輯 | 編輯原始碼]
應當先安裝並配置好 Lighttpd。lighttpd 的 server.modules array 中需要「mod_alias「和「mod_rewrite「。將以下內容添加至 lighttpd 的配置文件:
/etc/lighttpd/lighttpd.conf
alias.url += ("/mediawiki" => "/usr/share/webapps/mediawiki/") url.rewrite-once += ( "^/mediawiki/wiki/upload/(.+)" => "/mediawiki/wiki/upload/$1", "^/mediawiki/wiki/$" => "/mediawiki/index.php", "^/mediawiki/wiki/([^?]*)(?:\?(.*))?" => "/mediawiki/index.php?title=$1&$2" )
然後,重啟 lighttpd.service
守護進程。
資料庫[編輯 | 編輯原始碼]
按照你所需要的資料庫管理系統(DBMS)的文章配置資料庫伺服器:MariaDB、PostgreSQL、SQLite 或 MySQL。
如果資料庫密碼不為空,MediaWiki會自動創建資料庫(設置 MariaDB 密碼的方法在 MariaDB#Reset the root password) 。否則你就需要手動創建資料庫,詳情參考: upstream instructions。
LocalSettings.php[編輯 | 編輯原始碼]
在瀏覽器裡打開 wiki 的 URL (通常是 http://your_server/mediawiki/index.php
) 並進行初始化配置。參考upstream instructions的步驟。
生成的 LocalSettings.php
文件是用來下載的,保存它到 /usr/share/webapps/mediawiki/LocalSettings.php
。
自 1.38.0 版本起,/usr/share/webapps/mediawiki/LocalSettings.php
內已包含一個符號連結。
/etc/webapps/mediawiki/LocalSettings.php
文件:
# chown root:http /etc/webapps/mediawiki/LocalSettings.php # chmod 640 /etc/webapps/mediawiki/LocalSettings.php
該文件定義了所部署維基的特定設置。升級 mediawiki包 軟體包不會替換此文件。
LDAP Auth[編輯 | 編輯原始碼]
使用 PluggableAuth 和 LDAP Stack。請留意「Compatibility Matrix」章節。目前 LDAP 僅能與 PluggableAuth-5.7 一同使用。
請安裝並在配置中添加 ldap stack 擴展和 PluggableAuth:
- Extension:PluggableAuth
- Extension:LDAPProvider
- Extension:LDAPAuthentication2
- Extension:LDAPAuthorization
- Extension:LDAPUserInfo
- Extension:LDAPGroups
接下來請設置至少 3 個變量:
$LDAPProviderDomainConfigProvider
—— 整個 ldap 配置(可以是 json 文件)$wgPluggableAuth_Config
—— auth 插件列表
$wgPluggableAuth_Config = array( array('plugin' => 'LDAPAuthentication2'), array('plugin' => 'LDAPAuthorization'), );
- 以及
$LDAPProviderDefaultDomain
配置完成後請運行 php maintenance/update.php
。
升級[編輯 | 編輯原始碼]
參考 mw:Manual:Upgrading, 不要忘記運行:
# cd /usr/share/webapps/mediawiki # php maintenance/update.php
提示和技巧[編輯 | 編輯原始碼]
Unicode[編輯 | 編輯原始碼]
請確保PHP, Apache HTTP Server 和 MariaDB都用的是 UTF-8 編碼。否則可能遇到因為編碼不匹配導致的奇怪bug。
可視化編輯器[編輯 | 編輯原始碼]
VisualEditor(可視化編輯器)擴展為 MediaWiki 提供了一個富文本編輯器。請參照 mw:Extension:VisualEditor 安裝。