Manual:Upgrading to 1.10/zh


MediaWiki 1.10 在今年春季已经发布。通常,这将带来更多的功能,并修复一些错误,同以往一样,我们向大家提供这个升级的快速入门向导。

概述 edit

首先,请阅读包含在 MediaWiki 1.10 中的 UPGRADE 文本文件

无论什么时候升级 MediaWiki,都要进行以下步骤:

  1. 检查看是否满足系统要求
  2. 阅读发布说明(release notes)
  3. 备份已有文件和数据库
  4. 解压新文件
  5. 运行升级脚本以检查数据库
  6. 升级扩展(extensions)
  7. 测试升级后的系统

检查看是否满足系统要求 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 或更新版本
    同时需要安装 tsearch2plpgsql 模块

阅读发布说明(release notes) edit

在发布的 tar 档案文件(tarball)或是从 SVN 上导出的的文件中,有一些具有大写文件名的文件,其中的一个是 RELEASE-NOTES。请打开并看看在1.10中都进行了什么更改。

备份已有文件和数据库 edit

尽管升级程序通常是完善切强大的,一些事情仍然可能是不可预料的。在开始升级数据库架构前,请对 wiki 的数据库和文件同时做一个全面的备份

  • 存储在数据库中的 wiki 内容。最好在进行 SQL 数据库导出之外在生成一个 XML 导出。
  • 图像以及其它的媒体文件(images 文件夹下的内容)
  • 配置文件,如 LocalSettings.phpAdminSettings.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 进行升级。你需要这样做:

  1. LocalSettings.php 重命名为 LocalSettings.old.php
  2. 设置 config 目录可由 web 服务器写入
  3. 确保数据库用户对数据库有全部权限
  4. 访问 wiki 并启动安装程序

在表单中填入与上一次安装时相同的值。当安装过程开始时,脚本代码将会探测已有的 MediaWiki 数据表,并升级它们的架构。当完成时,将生成一个新的 LocalSettings.php 文件。

  1. 删除所生成的新配置文件
  2. LocalSettings.old.php 改回 LocalSettings.php
  3. 恢复 config 目录的访问权限

升级扩展(extensions) edit

为了能同 MediaWiki 1.10 一起工作,一些扩展已进行了更新。请确认已经更新到最新版本的扩展。对于自定义的扩展,你可能需要手动进行升级。

测试升级后的系统 edit

一旦升级完成,请浏览你的 wiki 并检查基本的功能如查看和编辑页面是否仍能如预期一样工作。

访问 Special:Version 并检查版本显示是否正确。