指示 - 升級

简介

如何升级取决于你如何在你的开发专案中使用 FuelPHP。

在任何情况下，我们假设你依循指示不对核心档案做任何改变， 在 app/classes 使用类别扩充来扩充核心功能， 并在你想要修改预设配置时複製核心配置档案到 app/config。

我只有下载并安装该 zip 档案

如果你已经採取这条路线，你可以再做一次。下载新版本的压缩档，并取代 fuel/core， 以及所有你有安装的 fuel/packages 。一旦完成了， 打开修改纪录并检查每一项变更对你应用程序的影响。

我的专案是在自己的储存库中，其中包括框架档案

使用相同的程序。下载压缩档，并取代档案。 把它们放进一个储存库让你利于查看差异， 这使得它更容易使用改版纪录来对你的应用程序进行必要的修改（如果需要的话）。

请注意 如果你（仍）使用 SVN，注意每个文件夹中隐藏的 svn 目录。取代档案时别删除它们。

我的专案是在自己的储存库中，我使用 FuelPHP 储存库做为子模组

如果你已经手动建立子模组，你了解它是如何运作的，以及如何升级它们。 如果你从一份 fuel/fuel 储存库的複製开始，添加它做为一个上游储存库，并且拉取（pull）新版本的 master 分支。 处理任何可能出现的合併问题，并运行一个 `git submodule update` 来更新发行版本的子模组。

我的专案是在自己的储存库中，我为 FuelPHP 组件使用独立的储存库

如果这些储存库是你自己的，添加 fuel 的做为上游远端储存库，并且拉取（pull）发行版本分支来更新你的档案。 然后推送（push）到你的储存库以完成更新。如果你直接使用 fuel 的储存库， 简单地切换分支。如果档案包含在你的应用程序储存库中， 推送（push）对你应用程序造成的变更以完成更新。

可能会有更多的情况。如果你有不同的情况，你觉得值得在此一提的话， 让我们知道或给我们发送一个此页面的拉取请求（pull request）。

那关于应用程序呢？

在多数情况下，当一个新版本推出，主要的 FuelPHP 储存库也会有变更， 而它已经成为你应用程序的一部份（即在 app 文件夹中的所有东西）。 如果你在建立应用程序时有对该文件夹做出大量修改的话，你必须要小心点。 潜在的三样事物可能已经被改变：

在 public 中的 index.php 档案

index.php 是 FuelPHP 框架不可或缺的一部份，它打理设置环境和引导框架。 当你升级到一个新版的 FuelPHP，别忘了从 fuel/fuel 储存库取代此文件。 如果你已经做了一些变动，别忘了移植到新的档案！

在 public 中包含的 asset 档案

虽然包含在 FuelPHP public/assets 中的档案不是框架的关键， 它们包含 Twitter Bootstrap 的档案，用在由 Oil 套件产生的 管理程式码。 由于新版本的 Bootstrap 将引入变动到框架使用的方式， 你必须检查产生的管理程式码标记，以确保它仍然能够与新版的 Bootstrap 一起运作。

其他包含的档案

其他可能需要升级的档案有 'Oil' 引导指令码和 .htaccess 档案，以及 PHPUnit 需要的档案。 如果你没有更动它们，只要以新版本取代， 以确保不会在使用时遇到问题。

使用上游储存库

如果你使用 git 来管理你的储存库，你可以添加 fuel/fuel 做为一个上游远端的储存库到你的储存库中。 这将能让你轻易地拉取（pull）更新。如果你使用各自独立的 FuelPHP 核心元件， 你同样也可以这幺做。当升级到一个较新的版本时， 可以节省你大量时间。