跳转至内容

MediaWiki

来自 ArchWiki

MediaWiki 是一款用 PHP 编写的免费开源 wiki 软件，最初为 Wikipedia 开发。MediaWiki 同时也驱动了本 wiki——另请参阅 archwiki 仓库。

安装

运行 MediaWiki 需要以下三项

要在 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 的注释。

为你的 DBMS 启用 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 的 open_basedir 并且想要允许文件上传，你需要包含 /var/lib/mediawiki/ (mediawiki 将 images/ 软链接到 /var/lib/mediawiki/)。

Web 服务器

Apache

参考 Apache HTTP Server#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 open_basedir 的行移动到 <Directory> 标签之间来更改此行为。此外，如果你运行多个依赖于同一服务器的应用程序，该值也可以添加到 /etc/php/php.ini 中的 open_basedir 值中，而不是 /etc/httpd/conf/extra/mediawiki.conf。

Nginx

本文或本章节的准确性存在争议。

原因： /mw-config/index.php 不应被公开，请参阅 Talk:MediaWiki#/mw-config/index.php is exposed with Nginx config。（在 Talk:MediaWiki 中讨论）

要使 MediaWiki 与 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 已启动。

包含一个 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;

}

最后，重启 nginx.service 和 php-fpm.service 守护进程。

Lighttpd

你应该已经安装并配置了 Lighttpd。lighttpd 的 server.modules 数组中需要 "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。

注意 对于 MariaDB/MySQL，MediaWiki 使用二进制排序规则 (binary collation)，因此在创建数据库时需要指定该排序规则
CREATE DATABASE mediawiki CHARACTER SET binary COLLATE binary;

如果你为数据库服务器设置了非空的 root 密码，MediaWiki 可以在下一步期间自动创建数据库。（关于如何回顾性地为 MariaDB 设置此密码，请参阅 MariaDB#Reset the root password。）否则需要手动创建数据库 - 请参阅上游指令。

Wiki 设置

现在你需要通过创建数据库表和配置文件 LocalSettings.php 来设置你的 wiki。有两种方法：通过命令行和通过浏览器，前者更安全，因为它不需要你公开安装程序。

警告 LocalSettings.php 包含数据库连接设置（如用户名和密码）以及 MediaWiki 基于 Web 的更新程序密码。请确保只有 root 和 http 用户有权访问 /etc/webapps/mediawiki/LocalSettings.php
# chown root:http /etc/webapps/mediawiki/LocalSettings.php
# chmod 640 /etc/webapps/mediawiki/LocalSettings.php

此文件定义了 wiki 的具体设置。每当你升级 mediawiki 软件包时，它不会被替换。

通过命令行

安装脚本有很多参数，完整详情请参考 MediaWiki 文档。这是一个基础示例

本文或本章节的准确性存在争议。

原因： 通过命令行选项设置密码是不安全的，因为密码会留在 shell 日志中并在系统进程列表中可见。（在 Talk:MediaWiki 中讨论）
# cd /etc/webapps/mediawiki/
# php maintenance/run.php install \
    --dbname=wikidb \
    --dbserver="localhost" \
    --installdbuser=root \
    --installdbpass=rootpassword \
    --dbuser=dbusername \
    --dbpass=dbuserpassword \
    --server="http://wiki.example.com/" \
    --scriptpath=/w \
    --lang=en \
    --pass=Adminpassword "Wiki Name" "Admin account name"

通过浏览器

在浏览器中打开 wiki URL（通常为 http://your_server/mediawiki/index.php）并进行初始配置。参考上游指令。

生成的 LocalSettings.php 文件将提供下载，请将其保存到 /etc/webapps/mediawiki/LocalSettings.php。

自 1.38.0 起，/usr/share/webapps/mediawiki/LocalSettings.php 中包含了一个符号链接。

LDAP 认证

使用 PluggableAuth 和 LDAP Stack。请注意 “Compatibility Matrix” 章节。目前 LDAP 仅与 PluggableAuth-5.7 协同工作。

你需要安装并在配置中添加 ldap stack 扩展和 PluggableAuth

然后设置至少 3 个变量

  • $LDAPProviderDomainConfigProvider - 整个 ldap 配置（可以是 json 文件）
  • $wgPluggableAuth_Config - 认证插件列表
$wgPluggableAuth_Config = array(
       array('plugin' => 'LDAPAuthentication2'),
       array('plugin' => 'LDAPAuthorization'),
);
  • 以及 $LDAPProviderDefaultDomain

不要忘记在配置后运行 php maintenance/update.php。

短 URL

Short URL 功能允许 wiki 文章以 SEO 友好的结构被访问（如 http://example.org/wiki/Article）。

以下假设使用的 URL 结构为 /wiki/$1，其中 $1 是文章名称。

Apache

在 /etc/httpd/conf/extra/mediawiki.conf 中添加重写规则

RewriteEngine On

# Short URL for wiki pages
RewriteRule ^/?wiki(/.*)?$ %{DOCUMENT_ROOT}/w/index.php [L]

# Redirect / to Main Page
RewriteRule ^/*$ %{DOCUMENT_ROOT}/w/index.php [L]

重启 httpd.service。

Nginx

在 /etc/nginx/mediawiki.conf 中添加重写规则

# Handling for Mediawiki REST API, see mw:API:REST_API
location /rest.php/ {
	try_files $uri $uri/ /w/rest.php?$query_string;
}

# Handling for the article path (pretty URLs)
location /wiki/ {
	rewrite ^/wiki/(?<pagename>.*)$ /index.php;
}

# Explicit access to the root website, redirect to main page (adapt as needed)
location = / {
	return 301 /wiki/Main_Page;
}

重启 nginx.service。

LocalSettings.php

追加到 /etc/webapps/mediawiki/LocalSettings.php

$wgArticlePath = "/wiki/$1";
$wgUsePathInfo = true;

你可能还想重写文章的页面动作 (page action) URL。若要这样做，请改为追加以下内容

## Use "/wiki/$action/$1" for page actions
$actions = [
	'view',
	'edit',
	'watch',
	'unwatch',
	'delete',
	'revert',
	'rollback',
	'protect',
	'unprotect',
	'markpatrolled',
	'render',
	'submit',
	'history',
	'purge',
	'info',
];

foreach ( $actions as $action ) {
  $wgActionPaths[$action] = "/wiki/$action/$1";
}

# Keep "/wiki/$1" for viewing articles
$wgActionPaths['view'] = "/wiki/$1";
$wgArticlePath = $wgActionPaths['view'];
$wgUsePathInfo = true;
提示 如果你托管一个公共 wiki，可以通过提交至 MediaWiki ShortURL Builder 来生成必要的短 URL 配置。

升级

参阅 mw:Manual:Upgrading，且不要忘记运行

# cd /usr/share/webapps/mediawiki
# php maintenance/run.php update

技巧与提示

Unicode

检查 PHP, Apache HTTP Server 和 MariaDB 是否全部使用 UTF-8。否则，你可能会因为编码不匹配而遇到奇怪的 Bug。

VisualEditor

VisualEditor MediaWiki 扩展为 MediaWiki 提供了富文本编辑器。参考 mw:Extension:VisualEditor 进行安装。

摘自 "https://wiki.archlinux.org.cn/index.php?title=MediaWiki&oldid=864674"

© . This site is unofficial and not affiliated with Arch Linux.

Content is available under GNU Free Documentation License 1.3 or later unless otherwise noted.