帮助:MediaWiki安装指南：修订间差异

本页给出通用安装流程，并提供本站当前环境可复用的参数示例。实际部署请以官方文档为准。

== 参考环境 ==

* 操作系统：Debian 12

* Web 服务器：Nginx

* PHP：8.2（PHP-FPM）

* 数据库：MariaDB 10.11

== 1. 安装系统依赖 ==

<syntaxhighlight lang="bash">

sudo apt update && sudo apt upgrade -y

sudo apt install nginx mariadb-server php8.2-fpm php8.2-cli php8.2-mysql php8.2-gd php8.2-mbstring php8.2-xml php8.2-curl php8.2-zip php8.2-intl php8.2-apcu unzip git -y

</syntaxhighlight>

== 2. 下载并解压 MediaWiki ==

<syntaxhighlight lang="bash">

cd /var/www

wget https://releases.wikimedia.org/mediawiki/1.45/mediawiki-1.45.0.tar.gz

tar -xzvf mediawiki-1.45.0.tar.gz

mv mediawiki-1.45.0 mediawiki

</syntaxhighlight>

== 3. 创建数据库与账号 ==

<syntaxhighlight lang="sql">

CREATE DATABASE my_wiki CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

CREATE USER 'wikiuser'@'localhost' IDENTIFIED BY '强密码';

GRANT ALL PRIVILEGES ON my_wiki.* TO 'wikiuser'@'localhost';

FLUSH PRIVILEGES;

</syntaxhighlight>

== 4. 运行安装向导 ==

访问：<code>https://你的域名/mw-config/</code>

完成后将生成的 <code>LocalSettings.php</code> 放入站点根目录。

== 5. 关键配置示例 ==

<syntaxhighlight lang="php">

$wgScriptPath = '';

$wgArticlePath = '/wiki/$1';

</syntaxhighlight>

== 6. 常用安装后维护 ==

<syntaxhighlight lang="bash">

php /var/www/mediawiki/maintenance/run.php update.php

php /var/www/mediawiki/maintenance/run.php rebuildrecentchanges.php

php /var/www/mediawiki/maintenance/run.php refreshLinks.php

php /var/www/mediawiki/maintenance/run.php runJobs.php

</syntaxhighlight>

== 7. 安全与排错 ==

* 确保 <code>LocalSettings.php</code> 权限最小化。

* 上传失败时检查 PHP 上传大小限制与目录权限。

* 页面无法渲染时优先检查 PHP-FPM 与 Nginx 日志。

== 官方文档 ==

* https://www.mediawiki.org/wiki/Manual:Installing_MediaWiki

{{Template:站点帮助文档}}

[[Category:帮助文档]]