Manual:Upgrading to 1.10/zh

From MediaWiki.org

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

Contents 1 概述 2 检查看是否满足系统要求 2.1 PHP 2.2 DBMS 3 阅读发布说明（release notes） 4 备份已有文件和数据库 5 解压新文件 6 运行升级脚本 6.1 Shell 6.2 替代方法 1: phpShell 6.3 替代方法 2: 再次运行安装程序 7 升级扩展（extensions） 8 测试升级后的系统

[edit] 概述

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

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

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

[edit] 检查看是否满足系统要求

MediaWiki 1.10 要求：

[edit] PHP

• PHP 5.0.x 或更新版本

  我们推荐使用 PHP 5.1.x.

  注意在某些64位平台上的 PHP 5.0.x 由于有 bugs 而可能使 MediaWiki 的一些基本功能出现问题。如果正在运行的平台是 x86_64 (AMD64, EMT64)或与64位平台有有脸, 则要求安装 PHP 5.1.x。

[edit] DBMS

• MySQL 4.0.x 或更新版本

  自从 1.6.0 以来已经不再支持 3.x 版了

或

• PostgreSQL 8.1 或更新版本

  同时需要安装 tsearch2 和 plpgsql 模块

[edit] 阅读发布说明（release notes）

在发布的 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 浏览器的安装程序来进行安装。

[edit] Shell

在命令行、SSH shell 或其它相似的环境中，进入 maintenance 目录并运行一下升级脚本：

$ php update.php

MediaWiki 将会检查已有的架构并对它进行升级，这些包括添加表和列。如果从 1.5.x 开始升级，一旦完成此步骤，还建议你运行 refreshLinks.php 脚本以升级链接表。

[edit] 替代方法 1: phpShell

如果无法通过 shell 访问，可以查看 phpShell 选项，它能用 PHP 函数模拟命令提示的功能。在一些被锁定的主机，这可能不起作用。

当使用此方法时，最好跳过开始时的倒计时阶段。可通过在升级命令上附加 --quick 来做到这个：

$ php update.php --quick

[edit] 替代方法 2: 再次运行安装程序

可以通过重新运行 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 目录的访问权限

[edit] 升级扩展（extensions）

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

[edit] 测试升级后的系统

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

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