老唐笔记
基于宝塔面板（BT Panel）搭建好了基础环境（LEMP），接下来的过程主要集中在 PHP 扩展配置、文件部署和 Web 安装上。MediaWiki 对 PHP 环境有一些特殊要求（特别是 intl 扩展），这是在宝塔环境下最容易踩坑的地方。
参考文章：
✅ 环境自检与准备
在开始之前，请确保您的宝塔环境满足以下 MediaWiki 的官方要求（以 2026 年主流版本为例）：
-
PHP: 推荐 PHP 8.1 或 8.2（最低 7.4.3）。
-
MySQL: 5.7+ 或 MariaDB 10.3+。
-
Nginx: 任意版本。
建站 VPS 推荐套餐：《2026 搬瓦工最新套餐分类：Basic VPS 基础套餐/E-Commerce 电子商务/Ultra 高端套餐》。
第一步：安装必要的 PHP 扩展 (关键)
MediaWiki 极其依赖 intl 和 fileinfo 扩展，默认的宝塔 PHP 安装包通常不包含 intl，会导致安装失败。
-
登录宝塔面板。
-
点击左侧 “软件商店” -> “已安装”。
-
找到您正在使用的 PHP 版本（例如 PHP-8.1），点击右侧的 “设置”。
-
在弹窗中选择 “安装扩展”。
-
安装以下扩展：
-
intl(必须，用于国际化支持) -
fileinfo(必须，用于文件类型检测) -
opcache(推荐，提升性能) -
imagemagick(推荐，用于图片缩略图处理)
-
-
安装完成后，点击 “服务” -> “重启” PHP 服务。
第二步：创建站点与数据库
-
点击左侧 “网站” -> “添加站点”。
-
域名： 填写您的 wiki 域名（如
wiki.example.com）。 -
数据库： 选择 MySQL，设置用户名和密码（请务必记下这两个信息）。
-
PHP版本： 选择刚才配置好扩展的那个版本。
-
点击 “提交”。
第三步：下载并上传 MediaWiki 程序
-
前往 MediaWiki 官方下载页。
-
下载最新的 Stable 版本（
.tar.gz格式）。 -
回到宝塔面板，点击 “文件”，进入刚才创建的网站根目录（通常是
/www/wwwroot/wiki.example.com）。 -
删除目录下默认的
index.html或404.html。 -
上传 刚才下载的压缩包。
-
解压 该压缩包。
-
移动文件： 解压后通常会多一层文件夹（如
mediawiki-1.4x.x）。请进入该文件夹，全选所有文件，使用 “剪切” -> 回到根目录 -> “粘贴”。-
确保
index.php直接位于网站根目录下。
-
-
检查权限： 点击右上角的“权限”，确保所有文件的所有者是
www，权限是755。
第四步：Web 图形化安装
-
在浏览器访问您的域名
http://wiki.example.com。 -
您应该能看到 MediaWiki 的欢迎界面，点击 “set up the wiki” (设置维基)。
-
语言选择： 选择
zh-cn - 中文（中国）。 -
环境检查： 如果第一步的扩展安装正确，这里会显示绿色的“环境检查通过”。
-
数据库配置：
-
数据库类型： MariaDB, MySQL 或兼容。
-
数据库主机：
localhost(或者127.0.0.1)。 -
数据库名、用户名、密码： 填入第二步中宝塔生成的账号密码。
-
表前缀： 保持默认
mw_即可。
-
-
一路点击“继续”，设置 Wiki 名称 和 管理员账号。
-
完成安装： 最后一步，系统会生成一个
LocalSettings.php文件并提示下载。
第五步：上传 LocalSettings.php (最重要)
MediaWiki 不会自动写入配置文件（出于安全考虑），您必须手动上传。
-
将浏览器自动下载的
LocalSettings.php文件保存到本地电脑。 -
回到 宝塔面板 -> 文件。
-
将这个文件 上传 到网站的根目录（和
index.php在一起）。 -
回到浏览器安装界面，刷新页面，您应该就能看到您的 Wiki 首页了！
第六步：配置 Nginx 伪静态 (短链接优化)
默认的链接带有 index.php (例如 wiki.example.com/index.php?title=Page)，非常丑陋且不利于 SEO。我们需要将其优化为 wiki.example.com/Page。
-
在宝塔面板中，点击 “网站” -> 点击您的 网站名 -> “伪静态”。
-
直接复制以下 Nginx 规则并粘贴进去，保存即可：
location / {
try_files $uri $uri/ @rewrite;
}
location @rewrite {
rewrite ^/(.*)$ /index.php?title=$1&$args;
}
location ^~ /maintenance/ {
return 403;
}
location ^~ /mw-config/ {
return 403;
}
- 修改 LocalSettings.php：在宝塔文件管理中编辑 LocalSettings.php，找到 $wgScriptPath 这一行，在下面添加或修改以下配置：
$wgScriptPath = ""; // 根目录安装设为空
$wgArticlePath = "/$1"; // 设置短链接格式
$wgUsePathInfo = true;
🚀 后续建议
-
开启缓存 (Redis)： MediaWiki 比较吃资源。建议在宝塔安装 Redis，并在
LocalSettings.php中配置$wgMainCacheType = CACHE_REDIS;（需要安装 PHP Redis 扩展）。 -
安全性： 安装完成后，建议在宝塔中将
mw-config文件夹重命名或删除，防止被他人重新运行安装程序。
