在介紹如何優雅升級 Flarum 之前，我先說下我們在正常使用中會產生有哪些比較重要的文件，如下：

/data1/www/flarumone├── assets│   ├── avatars     #存放用戶上傳的頭像，需要遷移│   └── uploads     #存放帖子和回復中所上傳的圖片，需要遷移└── config.php         #程序配置文件，需要遷移

重要：使用低于（含） FlarumOne 0.1.0 beta.2 150929a 版本的用戶，請將插件 extensions 文件夾下面的 reports 改為 flags 后再安裝（升級）

我們要規避舊系統中可能存在的歷史遺留問題，推薦采取整體替換程序的思路進行升級，如下：

• 約定：

  • 各版本路徑命名規則：產品名稱縮寫+版本號縮寫+內部版本號，例如： FlarumOne 0.1.0 beta.2 150923a 應寫為 fo010b2150923a ；而 Flarum 官方編譯版沒有對外提供內部版本號，我們則可以忽略，如 Flarum 0.1.0-beta.2 應寫為 f010b2
  • 舊版本：Flarum 0.1.0-beta.2
  • 新版本：FlarumOne 0.1.0 beta.2 150923a
  • 程序部署路徑： /data1/www/flarumone
  • 舊版備份路徑： /data1/www/f010b2
  • 新版釋放路徑： /data1/www/fo010b2150923a

• 流程：

  • 創建新版釋放路徑：

    mkdir /data1/www/fo010b2150929a

  • 下載新版并解壓到：

    wget -O /tmp/fo010b2150923a.zip
     http://res.szlt.net/project/flarumone/0.1.0-beta.2-150923a/flarumone.zipunzip
     /tmp/fo010b2150923a.zip
     -d /data1/www/fo010b2150923a 

  • 將需要遷移的數據徑拷貝到新版內：主要是程序部署路徑根目錄下面的程序配置文件 config.php 以及 assets 文件夾下面的頭像 avatars 和附件 uploads文件夾

    cp /data1/www/flarumone/config.php /data1/www/fo010b2150923acp
     -rf /data1/www/flarumone/assets/avatars /data1/www/fo010b2150923a/assetscp
      -rf /data1/www/flarumone/assets/uploads /data1/www/fo010b2150923a/assets

  • 改舊版路徑為 /data1/www/f010b2

    mv /data1/www/flarumone /data1/www/f010b2

  • 改新版路徑為 /data1/www/flarumone

    mv /data1/www/fo010b2150923a /data1/www/flarumone

  • 改 flags 插件路徑

    mv /data1/www/flarumone/extensions/reports /data1/www/flarumone/extensions/flags

  • 重置權限

    chown -R www:www /data1/www/flarumone

因為官方最近在對核心的架構做調整，最近一次提交上來的版本，存在和其它插件不兼容的問題（即最新版 FlarumOne 0.1.0 beta.2 150929a 無法全新安裝）。所以，我們就提供了下面這個變通的安裝方法

從 Flarum 官方的 0.1.0-beta.2 升級到 FlarumOne 0.1.0 beta.2 150929a 必須先升級到 FlarumOne 0.1.0 beta.2 150923a 然后再向 FlarumOne 0.1.0 beta.2 150929a 升級，可跳過 FlarumOne 0.1.0 beta.2 150926a 直接升級到該版本

特別強調，升級到 FlarumOne 0.1.0 beta.2 150923a 需要手動升級MySQL數據庫，全新安裝可以忽略！

首先登陸數據庫管理軟件，如 phpmyadmin ，然后選擇 flarum 所在的數據庫，然后選擇導入，導入文件：to23a.sql

操作數據庫前，記得備份！

下面以 Flarum 官方的 0.1.0-beta.2 升級到 FlarumOne 0.1.0 beta.2 150923a 版本為例（以后升級都可以參考這個方法）：

rm -rf /tmp/fo010b2150923a.zipmkdir /data1/www/fo010b2150923awget -O /tmp/fo010b2150923a.zip http://res.szlt.net/project/flarumone/0.1.0-beta.2-150923a/flarumone.zipunzip /tmp/fo010b2150923a.zip -d /data1/www/fo010b2150923acp /data1/www/flarumone/config.php /data1/www/fo010b2150923acp  -rf /data1/www/flarumone/assets/avatars /data1/www/fo010b2150923a/assetscp  -rf /data1/www/flarumone/assets/uploads /data1/www/fo010b2150923a/assetsmv /data1/www/flarumone /data1/www/f010b2mv /data1/www/fo010b2150923a /data1/www/flarumonemv /data1/www/flarumone/extensions/reports /data1/www/flarumone/extensions/flagschown -R www:www /data1/www/flarumone

最后，附上 FlarumOne 0.1.0 beta.2 150923a 升級 FlarumOne 0.1.0 beta.2 150929a 的詳細步驟：

rm -rf /tmp/fo010b2150929a.zipmkdir /data1/www/fo010b2150929awget -O /tmp/fo010b2150929a.zip http://res.szlt.net/project/flarumone/0.1.0-beta.2-150929a/flarumone.zipunzip /tmp/fo010b2150929a.zip -d /data1/www/fo010b2150929acp  /data1/www/flarumone/config.php /data1/www/fo010b2150929acp  -rf /data1/www/flarumone/assets/avatars /data1/www/fo010b2150929a/assetscp  -rf /data1/www/flarumone/assets/uploads /data1/www/fo010b2150929a/assetsmv /data1/www/flarumone /data1/www/fo010b2150923amv /data1/www/fo010b2150929a /data1/www/flarumonemv /data1/www/flarumone/extensions/reports /data1/www/flarumone/extensions/flagschown -R www:www /data1/www/flarumone

到這里，你可能看到了一個全是字符串的首頁，別著急，請去點擊右上角的頭像圖標，在下拉菜單選擇后臺（倒數第二個），然后去開啟一個叫 中文簡體 的插件 ，然后再去前臺刷新頁面，一切又恢復了往常的平靜。