MediaWiki (简体中文) - ArchWiki

Jump to content

# MediaWiki (简体中文)

From ArchWiki
翻译状态：本文是 MediaWiki 的翻译。上次翻译日期：2019-01-17。如果英文版本有所更改，则您可以帮助同步翻译。
注意： MediaWiki 还没有完全支持 PHP 7.3。[1][2]

MediaWiki 是一个免费、开源的维基软件，用 PHP 写成；原本是为维基百科开发的。它也给 archwiki 提供了帮助。（详情查看 Special:Version 和 GitHub repository）。

## 安装

为了运行 MediaWiki 你需要三个组件：

- mediawiki 包，PHP 会作为它的依赖安装
- 一个网站服务器 – Apache、Nginx 或者 Lighttpd
- 一个数据库系统 – MySQL、PostgreSQL 或者 SQLite

如果要在 XAMPP 上安装 MediaWiki，参见 mw:Manual:Installing MediaWiki on XAMPP

## Configuration

The steps to achieve a working MediaWiki configuration involve editing the PHP settings and adding the MediaWiki configuration snippets.

### PHP

MediaWiki 需要 `iconv` 插件，所以需要把 `/etc/php/php.ini` 里面的 `extension=iconv` 取消注释。

可选插件：

- 为了渲染缩略图，安装 ImageMagick 或者 php-gd（二选一）。如果安装的是后者，需要取消注释 `extension=gd`。
- 为了更高效率的 Unicode normalization，安装 php-intl 并取消注释 `extension=intl`。

启用你的数据库管理系统的 API：

- 如果是 MariaDB，取消注释`extension=mysqli`。
- 如果是 PostgreSQL，安装 php-pgsql 并取消注释 `extension=pgsql`。
- 如果是 SQLite，安装 php-sqlite 并取消注释 `extension=pdo_sqlite`。

Second, tweak the session handling or you might get a fatal error (`PHP Fatal error: session_start(): Failed to initialize storage module[...]`) by finding the `session.save_path` path. A good choice can be `/var/lib/php/sessions` or `/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 ~ \.php5?$ {
       include /etc/nginx/fastcgi_params;
       fastcgi_pass unix:/var/run/php-fpm/php-fpm.sock;
       fastcgi_index index.php5;
       fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
       try_files $uri @mediawiki;
    }
    location ~* \.(js|css|png|jpg|jpeg|gif|ico)$ {
       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;
    }

请确保 php-fpm 已安装并 start 了。

在`/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

You should have Lighttpd installed and configured. "mod_alias" and "mod_rewrite" in server.modules array of lighttpd is required. Append to the lighttpd configuration file the following lines

    /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"
    )

Restart the `lighttpd.service` daemon.

### 数据库

按照你所需要的数据库管理系统（DBMS）的文章配置数据库服务器：MySQL、PostgreSQL 或者 SQLite。

如果你在下一步里提供了数据库的 root 密码，MediaWiki会自动创建数据库。否则你就需要手动创建数据库，详情参考： upstream instructions。

### LocalSettings.php

在浏览器里打开 wiki 的 url (通常是 `http://your_server/mediawiki/`) 并进行初始化配置。参考upstream instructions的步骤。

生成的 `LocalSettings.php` 文件是用来下载的，保存它到 `/usr/share/webapps/mediawiki/LocalSettings.php`。这个文件记录了你的 wiki 的配置，升级 mediawiki 包是不会覆盖它的。

## Tips and tricks

### 数学 (texvc)

通常来说，安装 texvc 并在配置文件里启用它就可以了：

    $wgUseTeX = true;

如果遇到问题，尝试提高以下的 shell 命令限制值：

    $wgMaxShellMemory = 8000000;
    $wgMaxShellFileSize = 1000000;
    $wgMaxShellTime = 300;

### Unicode

请确保 php、 apache 和 mysql 都用的是 UTF-8 编码。否则你可能遇到因为编码不匹配导致的奇怪bug。

### VisualEditor

The VisualEditor MediaWiki extension provides a rich-text editor for MediaWiki. Follow mw:Extension:VisualEditor to install it.

You will also need the Parsoid Node.js backend, which is available from the AUR as parsoid-gitAUR.

Adjust the path to MediaWiki in `/usr/share/webapps/parsoid/api/localsettings.js`:

    parsoidConfig.setInterwiki( 'localhost', 'http://localhost/mediawiki/api.php' );

After that enable and start `parsoid.service`.

Alternatively, one may also use the parsoidAUR package, and configure the service via the yaml file, where the following lines should be present:

    /usr/share/webapps/parsoid/config.yaml

    uri: `'http://localhost/mediawiki/api.php'`
    domain: 'localhost'

The matching part in the mediawiki settings:

    /usr/share/webapps/mediawiki/LocalSettings.php

    $wgVirtualRestConfig['modules']['parsoid'] = array(
      // URL to the Parsoid instance - use port 8142 if you use the Debian package - the parameter 'URL' was first used but is now deprecated (string)
      'url' => 'http://localhost:8000/',
      // Parsoid "domain" (string, optional) - MediaWiki >= 1.26
      'domain' => 'localhost',
      // Parsoid "prefix" (string, optional) - deprecated since MediaWiki 1.26, use 'domain'
      'prefix' => 'localhost',
      // Forward cookies in the case of private wikis (string or false, optional)
      'forwardCookies' => false,
      // request timeout in seconds (integer or null, optional)
      'timeout' => null,
      // Parsoid HTTP proxy (string or null, optional)
      'HTTPProxy' => null,
      // whether to parse URL as if they were meant for RESTBase (boolean or null, optional)
      'restbaseCompat' => null,
    );

After configuration, the `parsoid` service may be started (restarted) and (if not done yet) enabled.

Category:

- Wiki software (简体中文)