Manual:Upgrading to 1.10/zh
This page contains information on upgrading to a non-current version of MediaWiki. You are advised to upgrade to version 1.42.3 if possible. Instructions for this can be found at Manual: . |
稳定版本 (MediaWiki 1.42 )
- mediawiki-1.42.3.tar.gz
- mediawiki-1.42.3.zip
- Git分支: REL1_42
旧版本 (MediaWiki 1.41 )
- mediawiki-1.41.4.tar.gz
- mediawiki-1.41.4.zip
- Git分支: REL1_41
测试版 (MediaWiki 1.44 )
更多信息:
MediaWiki 1.10 在今年春季已经发布。通常,这将带来更多的功能,并修复一些错误,同以往一样,我们向大家提供这个升级的快速入门向导。
概述
[edit]首先,请阅读包含在 MediaWiki 1.10 中的 UPGRADE 文本文件。
无论什么时候升级 MediaWiki,都要进行以下步骤:
- 检查看是否满足系统要求
- 阅读发布说明(release notes)
- 备份已有文件和数据库
- 解压新文件
- 运行升级脚本以检查数据库
- 升级扩展(extensions)
- 测试升级后的系统
检查看是否满足系统要求
[edit]MediaWiki 1.10 要求:
PHP
[edit]- PHP 5.0.x 或更新版本
- 我们推荐使用 PHP 5.1.x.
- 注意在某些64位平台上的 PHP 5.0.x 由于有 bugs 而可能使 MediaWiki 的一些基本功能出现问题。如果正在运行的平台是 x86_64 (AMD64, EMT64)或与64位平台有有脸, 则要求安装 PHP 5.1.x。
DBMS
[edit]- MySQL 4.0.x 或更新版本
- 自从 1.6.0 以来已经不再支持 3.x 版了
或
- PostgreSQL 8.1 或更新版本
- 同时需要安装
tsearch2
和plpgsql
模块
- 同时需要安装
阅读发布说明(release notes)
[edit]在发布的 tar 档案文件(tarball)或是从 SVN 上导出的的文件中,有一些具有大写文件名的文件,其中的一个是 RELEASE-NOTES。请打开并看看在1.10中都进行了什么更改。
备份已有文件和数据库
[edit]尽管升级程序通常是完善切强大的,一些事情仍然可能是不可预料的。在开始升级数据库架构前,请对 wiki 的数据库和文件同时做一个全面的备份:
- 存储在数据库中的 wiki 内容。最好在进行 SQL 数据库导出之外在生成一个 XML 导出。
- 图像以及其它的媒体文件(
images
文件夹下的内容) - 配置文件,如
LocalSettings.php
和AdminSettings.php
(如果有的话) - MediaWiki 程序文件,包括所有的皮肤和扩展,特别是你所更改的部分。
请参见 Manual:Backing up a wiki 的更多指示说明。
解压新文件
[edit]如果使用的是从 SourceForge 下载的 tar 文件包,请将其解压。如果使用的 Subversion, 将文件导入到一个空文件夹中。把所有已有的文件用新版本的文件替换,保留原来的目录结构。现在内核代码已经是最新的了。
运行升级脚本
[edit]注意: 请确认在根目录下有 AdminSettings.php
文件,并且其中的配置信息已经随系统的变化更新了。其中的用户必须具有操作数据库的所有权限。
首选的升级方法是运行命令行维护脚本,但是,也可以通过重新运行基于 web 浏览器的安装程序来进行安装。
Shell
[edit]在命令行、SSH shell 或其它相似的环境中,进入 maintenance
目录并运行一下升级脚本:
$ php update.php
MediaWiki 将会检查已有的架构并对它进行升级,这些包括添加表和列。如果从 1.5.x 开始升级,一旦完成此步骤,还建议你运行 refreshLinks.php
脚本以升级链接表。
替代方法 1: phpShell
[edit]如果无法通过 shell 访问,可以查看 phpShell 选项,它能用 PHP 函数模拟命令提示的功能。在一些被锁定的主机,这可能不起作用。
当使用此方法时,最好跳过开始时的倒计时阶段。可通过在升级命令上附加 --quick
来做到这个:
$ php update.php --quick
替代方法 2: 再次运行安装程序
[edit]可以通过重新运行 web 安装程序来替代从 shell 进行升级。你需要这样做:
- 将
LocalSettings.php
重命名为LocalSettings.old.php
- 设置
config
目录可由 web 服务器写入 - 确保数据库用户对数据库有全部权限
- 访问 wiki 并启动安装程序
在表单中填入与上一次安装时相同的值。当安装过程开始时,脚本代码将会探测已有的 MediaWiki 数据表,并升级它们的架构。当完成时,将生成一个新的 LocalSettings.php
文件。
- 删除所生成的新配置文件
- 将
LocalSettings.old.php
改回LocalSettings.php
- 恢复
config
目录的访问权限
升级扩展(extensions)
[edit]为了能同 MediaWiki 1.10 一起工作,一些扩展已进行了更新。请确认已经更新到最新版本的扩展。对于自定义的扩展,你可能需要手动进行升级。
测试升级后的系统
[edit]一旦升级完成,请浏览你的 wiki 并检查基本的功能如查看和编辑页面是否仍能如预期一样工作。
访问 Special:Version 并检查版本显示是否正确。