简介

如何升級取決於你如何在你的开发專案中使用 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 核心元件, 你同樣也可以这麼做。當升級到一个較新的版本時, 可以節省你大量時間。