编辑“Gallery:升级”

= 详细指导 =
更新既快又简单，只需数分钟即可完成。

== 做好备份==
升级过程应该是相当安全的。但有备无患，做好备份绝不是多余之举。因此在执行升级之前，你应当 [[Gallery:How_do_I_Make_Backups_of_My_Database|备份数据库]]。一旦发生不测你可以随时回复数据库并重试。如果你对Gallery2代码拷贝做了修改的话，就应该对修改做备份以防更新过程会进行重写。

:'''接下来：''' [[Gallery:Upgrading_to_2.0.x#识别你的Gallery2版本|识别你的Gallery2版本]]

== 识别你的Gallery2版本 ==

为了能够进行升级，你需要了解你当前所使用Gallery2的版本。在浏览器中打开Gallery2，以管理员身份登入，点击"站点管理（Site Admin）"链接，接着点击"维护（Maintenance）"链接。现在你就会看到一个罗列有维护任务的列表了。在每个任务的旁边标记有''系统信息（System Information）''，点击'''现在运行（run now）'''链接，接着查找标有''Gallery version''的一行。 

:'''接下来：''' [[Gallery:Upgrading#回顾发布版本注解和已知问题|回顾发布版本注解和已知问题]]

==回顾发布版本注解和已知问题==

在开始升级之前，你需要回顾一下最新Gallery2版本注解并浏览一下[[Gallery:Known_Issues|已知问题]]。

Gallery2的要求（比如要求PHP达到某个版本）可能会改变或者是可能对应你进行的安装可能会有问题记载。

:'''接下来：''' [[Gallery:Upgrading#升级应用程序文件|升级应用程序文件]]

==升级应用程序文件==
有三种方法可以进行升级：
# [[Gallery:Upgrading#替换所有文件|替换所有文件]]：下载整个Gallery2的完整替代。这回比较慢，但是很可靠。
# [[Gallery:Upgrading#使用更新文件|使用更新文件]]：仅替换自主要版本发布以来的修改内容。此选项仅对安全性&amp;补丁发布可用。如果你修改了Gallery2代码，此方法将保留你所作的修改。此方法比替换所有文件的方法要快，但是需要了解相关的知识。
# [[Gallery:Upgrading#由Subversion进行更新|由Subversion进行更新]]：如果你对Gallery2代码做了修改，那么这就是最好的办法了。此方法相对较快并且不会牵扯进你所作的修改，但是需要极为熟悉相关的知识，因此对于大部分用户来说，这个方法并非那么容易就能掌握的。 

===替换所有文件===
[[Gallery:Download#整合包 下载全新Gallery2拷贝]]并直接将其解压到现有的Gallery2安装之上，然后运行升级程序。此方法简单并且彻底，但速度就比较慢了。另外，你对Gallery2所作的所有修改将在文件被替换之后'''丢失'''，但在''本地''目录中所作的模板改动不会受影响。

'''注'''：
* '''Pre-Installer'''也可用于新版本至网站的快速上传。
** 参见：[[Gallery:Preinstaller#Upgrading|使用Pre-Installer进行升级]]。
** 如果使用预安装程序安装了Gallery的话，请参见 [[Gallery:Preinstaller#升级一个已安装有Pre-Installer的G2 |升级一个已安装有Pre-Installer的G2]]。
** 如果你希望升级时不使用pre-installer但是Gallery安装有pre-installer的话，请参见： [[Gallery:Preinstaller#将已安装有Pre-Installer的G2转为通常型|将已安装有Pre-Installer的G2转为通常型]]。
* Gallery2整合包有四类（典型，最小，完整以及开发者）。你所下载的整合包类型应当与你之前所用的类型相同。 

:'''接下来''': [[Gallery:Upgrading#运行基于web的升级程序|运行基于web的升级程序]]

===使用更新文件 ===

首先[[#识别你的Gallery2版本|确定实际的Gallery版本--Gallery 2.x.y]]（如Gallery 2.2.1）。

更新文件仅对如下版本可用：
* [[Gallery:Upgrading_to_2.2.x|由Gallery 2.2.x升级到2.2.y]]（如2.2到2.2.1）
* [[Gallery:Upgrading_to_2.1.x|由Gallery 2.1.x升级到2.1.y]]（如2.1.1a到2.1.2）
* [[Gallery:Upgrading_to_2.0.x|由Gallery 2.0.x升级到2.0.y]]（如2.0到2.0.4）

===由Subversion进行更新===

如果你是自 [[Gallery:Using_Subversion|Subversion]] 进行Gallery2安装的话，你可以直接运行：

<pre>
svn update
</pre>

这将会为你获取原先进行check out区域的最新代码。如果你check out BRANCH_2_2那么将会取得最新2.2.x版本，而如果是trunk的话，结果就会是最新的开发代码。

:'''接下来''': [[Gallery:Upgrading#运行基于web的升级程序|运行基于web的升级程序]]

==运行基于web的升级程序==

一旦你的文件更新完了，在web浏览器中打开Gallery2，就会自动引导至升级程序。请按照如下指导操作。

在升级程序进行到第二步时，''Gallery文件完整性''检查应当显示<font color="green">成功</font>。如果有列出缺失/被删除/被篡改的文件的话，你应当确保是你自己在拷贝中对这些文件做了修改。如果报告自modules/core/test目录有超过100个缺失文件的话，请确认你没有无意间将被修改文件的开发者整合zip安装至某源自最小化，典型或完整版本上。如果确实发生了这种情况，没关系！请返回并获取正确的zip文件，接着重试即可。

'''注：'''
* 如果你使用PHP 加速器/缓存（如Turk mmCache，Ioncube PHPA，eaccelerator，Zend Studio等）请清除加速器的缓存。忽略此步骤的话有时会导致等级过程中或升级完成后出现错误。
* 如果尚未进行此操作的话，那么请你'''在升级核心模块之前备份Gallery'''！
 
成功完成之后，你就会回到最新版本的Gallery2中，万事大吉了。

= 有关升级=
新的Gallery 2发布版本带有新且改良后的特点，还包括bug的修复。

== 主要发布版本 ==
2.0是Gallery2的第一个官方发布版本。Gallery 2.1的发布约是半年之后，接着是2.2。这些都是Gallery2的主要发布版本，它们都带有新且经改良的特点以及或大或小的bug修正。 

请注意Gallery 2.3将会是最后一个能与PHP4和PHP5兼容的主要发布版本。Gallery 2.4起将仅支持PHP5。相关的公告：[http://gallery.menalto.com/gallery_2_and_php5 2008年首次发布的Gallery版本需要PHP5的支持]。

你应当订阅 [[Mailing_Lists|公告邮件发送列表]]来获取所有重要更新的相关信息。

== 安全性及补丁发布 ==
如果我们发布了安全性漏洞补丁的话，你应当尽快进行升级以保证其不受攻击。

安全性升级可通过版本号轻易地辨别出来。所有的gallery2版本号都遵循x.y.z的形式。'x'肯定总是'2'。'y'随着主要（较大）更新而改变。而'z'则是安全性及补丁更新。

我们努力保证安全性及补丁的发布处于最小限度，通常只有重要的安全性漏洞补丁或经测试及质量测评认可的重要bug才会考虑发布。

这就是安全性更新仅包括具有针对性的问题修复的原因了。在安全性升级时，你不会获得其他的bug修复及新特色。但这也意味着要重新上传的文件量不会太大。因此安全性升级既快又简单。

还需注意最新的稳定发布版本总是包括了所有的安全性修复及补丁。

如果你已有某Gallery2特定版本而需要安装安全性补丁的话，请参见：[[Gallery:Upgrading#使用更新文件|使用更新文件]]

== 升级到nightly快照版和开发版本 ==
Gallery2是在一个中央源代码存储库中进行管理的，我们则将该存储库当前状态理解为Gallery2的'开发版本'。Gallery开发者们正努力保证此开发版本的稳定性。

'''nightly snapshot'''则是Gallery当前开发版本的拷贝整合包，它是很“新鲜”的，从发布开始不会超过24小时。

尽管某些质保测试是定期的，但我们向用户推荐使用最新官方版本而不推荐开发版本是有原因的。最新的开发版本可能具有的新特点会让你觉得不便于用在网站上，而很多测试，修改，质保存是都是针对官方正式发布版本进行的，开发版本则很少被顾及到。

然而，还是有人欣赏开发版本较高的品质，而且真正用在了服务器上。而某些时候我们会对特定用户群推荐使用nighly snapshot，因为这些人可能正受自上个正式版本发布以来某特定问题的困扰。

nightly snapshot和开发版本的升级跟官方正式版本的并无二致。

注：你还可以使用 [[Gallery:Preinstaller#升级|Pre-Installer]]来升级到某个nightly快照版。

== 多站点（Multisite）的升级 ==
参见：[[Gallery:Multisite#如何升级一个多站点|如何升级一个多站点]]

== 整合Gallery的升级==
如果你的Gallery是被整合到另一个应用程序（CMS，blog，门户，论坛等）中的话，那么首先你需要确保新的Gallery版本与其他的应用程序相兼容。另外你还得查看一下是否有对应你所使用的应用程序的更新整合。最好参考一下 [[Gallery:Integration:Available_Integrations|特定整合的项目网站]]。

除此之外，升级过程与独立的或一般的Gallery2升级过程是一样的。

[[Category:Gallery 2:Installation]]