MediaWiki升级指南：从备份到测试的完整流程

MediaWiki升级指南：从备份到测试的完整流程

mediawiki 🌻 The collaborative editing software that runs Wikipedia. Mirror from https://gerrit.wikimedia.org/g/mediawiki/core. See https://mediawiki.org/wiki/Developer_access for contributing. 项目地址: https://gitcode.com/gh_mirrors/me/mediawiki

前言

MediaWiki作为知名的开源维基引擎，其升级过程需要谨慎操作。本文将从技术角度全面解析MediaWiki的升级流程，帮助管理员安全、高效地完成版本更新。

升级前的准备工作

1. 版本兼容性检查

• 当前版本要求：任何低于1.35的版本都无法直接升级到最新版
• LTS版本策略：如果当前版本落后两个LTS版本以上，必须先升级到较新的LTS版本

2. 查阅发布说明

在开始升级前，必须仔细阅读新版本的发布说明，重点关注：

• 已修复的bug列表
• 新增功能特性
• 升级过程中的特殊注意事项
• 配置变量的变更情况

3. 完整备份策略

数据库备份：

• 使用数据库管理工具执行完整备份
• 验证备份文件的完整性
• 考虑使用事务性备份确保数据一致性

文件系统备份：

• 备份整个MediaWiki安装目录
• 特别注意保留LocalSettings.php配置文件
• 确保images目录（用户上传文件）完整备份

升级执行阶段

1. 文件系统更新

1. 获取新版MediaWiki文件包
2. 解压到临时目录
3. 保留以下关键目录和文件：
   • LocalSettings.php
   • extensions/（扩展目录）
   • images/（上传目录）
   • 自定义皮肤目录
   • 自定义上传目录（如配置了$wgUploadDirectory）

2. 数据库架构升级

网页界面升级方式

访问mw-config/index.php，按照向导完成升级

命令行升级方式（推荐）

cd maintenance/
php run.php update

高级选项：

• --schema：仅生成架构变更SQL而不执行
• --noschema：跳过架构变更只执行数据迁移
• 结合$wgAllowSchemaUpdates配置可实现权限分离

升级后验证

1. 配置检查

核对LocalSettings.php中的配置项，注意：

• 已弃用的配置变量（如$wgDisableUploads→$wgEnableUploads）
• 新增的配置选项
• 默认值变更的配置项

2. 扩展兼容性

• 检查所有已安装扩展的版本要求
• 更新不兼容的扩展
• 测试各扩展功能是否正常

3. 全面功能测试

测试重点包括：

• 基本页面浏览和编辑功能
• 特殊页面（如最近更改、用户列表等）
• 文件上传和处理
• 用户权限系统
• 搜索功能
• 所有关键扩展的功能验证

最佳实践建议

1. 分阶段升级：对于大型wiki，考虑先在测试环境验证升级过程
2. 维护窗口：选择低流量时段执行升级
3. 回滚计划：预先制定详细的回滚方案
4. 监控：升级后密切监控系统日志和性能指标

常见问题处理

如果升级过程中遇到问题：

1. 检查错误日志获取详细信息
2. 查阅对应版本的已知问题列表
3. 确保所有前置条件（如PHP版本、数据库版本）满足要求
4. 考虑分段执行升级（先升级到中间版本）

通过遵循本指南的系统化升级流程，可以最大限度地降低MediaWiki升级风险，确保wiki平台的平稳过渡。记住，谨慎的规划和充分的测试是成功升级的关键。

mediawiki 🌻 The collaborative editing software that runs Wikipedia. Mirror from https://gerrit.wikimedia.org/g/mediawiki/core. See https://mediawiki.org/wiki/Developer_access for contributing. 项目地址: https://gitcode.com/gh_mirrors/me/mediawiki