Manual:Upgrading to 1.10/zh



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

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

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


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

检查看是否满足系统要求
MediaWiki 1.10 要求：

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.

DBMS

 * MySQL 4.0.x 或更新版本
 * 自从 1.6.0 以来已经不再支持 3.x 版了

或


 * PostgreSQL 8.1 或更新版本
 * 同时需要安装 tsearch2 和 plpgsql 模块

阅读发布说明（release notes）
在发布的 tar 档案文件（tarball）或是从 SVN 上导出的的文件中，有一些具有大写文件名的文件，其中的一个是 RELEASE-NOTES. 请打开并看看在1.10中都进行了什么更改.

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


 * 存储在数据库中的 wiki 内容. 最好在进行 SQL 数据库导出之外在生成一个 XML 导出.
 * 图像以及其它的媒体文件（images 文件夹下的内容）
 * 配置文件，如 LocalSettings.php 和 AdminSettings.php （如果有的话）
 * MediaWiki 程序文件，包括所有的皮肤和扩展，特别是你所更改的部分.

请参见 Manual:Backing up a wiki 的更多指示说明.

解压新文件
如果使用的是从 SourceForge 下载的 tar 文件包，请将其解压. 如果使用的 Subversion, 将文件导入到一个空文件夹中. 把所有已有的文件用新版本的文件替换，保留原来的目录结构. 现在内核代码已经是最新的了.

运行升级脚本
注意： 请确认在根目录下有 AdminSettings.php 文件，并且其中的配置信息已经随系统的变化更新了. 其中的用户必须具有操作数据库的所有权限.

首选的升级方法是运行命令行维护脚本，但是，也可以通过重新运行基于 web 浏览器的安装程序来进行安装.

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

$ php update.php

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

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

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

$ php update.php --quick

替代方法 2: 再次运行安装程序
可以通过重新运行 web 安装程序来替代从 shell 进行升级. 你需要这样做：


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

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


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

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

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

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