MediaWiki - Arch Linux 中文维基

跳至內容

# MediaWiki

出自 Arch Linux 中文维基
翻譯狀態：

- 本文（或部分內容）譯自 MediaWiki，最近一次同步於 2024-08-13，若英文版本有所更改，則您可以幫助同步與翻譯更改的內容。
- 您可以在 ArchWiki 的對應頁面找到本文翻譯的原始修訂歷史。
- 本文可能與英文原文存在出入。

MediaWiki 是一個自由、開源的維基軟體，用 PHP 寫成；原本是為維基百科開發的。它也給 ArchWiki 和本維基提供了幫助。（詳情查看 Special:版本和 GitHub 倉庫）。

## 安裝

為了運行 MediaWiki 你需要三個組件：

- mediawiki包 包，PHP 會作為它的依賴安裝
- 一個網絡伺服器――例如 Apache HTTP 伺服器、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` 內已包含一個符號連結。

警告：LocalSettings.php 包含了資料庫連接設置（例如用戶名和密碼）和網絡更新密碼。請確保僅 root 和 http 用戶可以訪問 `/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 安裝。

分類：​

- 維基軟體

MediaWiki
新增話題