在介绍如何优雅升级 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.zip
mkdir /data1/www/fo010b2150923a
wget -O /tmp/fo010b2150923a.zip http://res.szlt.net/project/flarumone/0.1.0-beta.2-150923a/flarumone.zip
unzip /tmp/fo010b2150923a.zip -d /data1/www/fo010b2150923a
cp /data1/www/flarumone/config.php /data1/www/fo010b2150923a
cp  -rf /data1/www/flarumone/assets/avatars /data1/www/fo010b2150923a/assets
cp  -rf /data1/www/flarumone/assets/uploads /data1/www/fo010b2150923a/assets
mv /data1/www/flarumone /data1/www/f010b2
mv /data1/www/fo010b2150923a /data1/www/flarumone
mv /data1/www/flarumone/extensions/reports /data1/www/flarumone/extensions/flags
chown -R www:www /data1/www/flarumone

最后，附上 FlarumOne 0.1.0 beta.2 150923a 升级 FlarumOne 0.1.0 beta.2 150929a 的详细步骤：

rm -rf /tmp/fo010b2150929a.zip
mkdir /data1/www/fo010b2150929a
wget -O /tmp/fo010b2150929a.zip http://res.szlt.net/project/flarumone/0.1.0-beta.2-150929a/flarumone.zip
unzip /tmp/fo010b2150929a.zip -d /data1/www/fo010b2150929a
cp  /data1/www/flarumone/config.php /data1/www/fo010b2150929a
cp  -rf /data1/www/flarumone/assets/avatars /data1/www/fo010b2150929a/assets
cp  -rf /data1/www/flarumone/assets/uploads /data1/www/fo010b2150929a/assets
mv /data1/www/flarumone /data1/www/fo010b2150923a
mv /data1/www/fo010b2150929a /data1/www/flarumone
mv /data1/www/flarumone/extensions/reports /data1/www/flarumone/extensions/flags
chown -R www:www /data1/www/flarumone

到这里，你可能看到了一个全是字符串的首页，别着急，请去点击右上角的头像图标，在下拉菜单选择后台（倒数第二个），然后去开启一个叫 中文简体 的插件 ，然后再去前台刷新页面，一切又恢复了往常的平静。