MediaWiki

出自 ArchWiki

MediaWiki 是一个自由开源的 wiki 软件，使用 PHP 编写，最初为维基百科开发。它也驱动着本 wiki (参见 Special:Version 和 GitHub 仓库)。

安装

要运行 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。

其次，调整会话处理，否则你可能会遇到致命错误 (PHP Fatal error: session_start(): Failed to initialize storage module[...])，通过查找 session.save_path 路径。一个好的选择可以是 /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 开头的行到 <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 已启动。

包含一个服务器指令，类似于这样

/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。

如果你为数据库服务器设置了非空的 root 密码，MediaWiki 可以在下一步中自动创建数据库。（有关如何追溯为 MariaDB 设置此密码，请参阅 MariaDB#Reset the root password。）否则，需要手动创建数据库 - 参见 上游说明。

LocalSettings.php

在浏览器中打开 wiki URL (通常是 http://your_server/mediawiki/index.php) 并进行初始配置。按照 上游说明 操作。

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

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

警告： 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 软件包，它都不会被替换。

LDAP 认证

使用 PluggableAuth 和 LDAP Stack。注意 "兼容性矩阵" 章节。目前 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。

升级

参见 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 安装它。

Retrieved from "https://wiki.archlinux.org.cn/index.php?title=MediaWiki&oldid=825944"