# 1.4 升级指南

此为创业版、旗舰版 1.4.0 升级指南，使用开源版本请忽略。

1.4.0 版主要是功能新增，也对一些优化进行了重构优化，如果您的项目已经投入了业务使用，那么可以根据下面的内容点来调整您的项目。如果您是一个新的项目，按照文档重新安装 (opens new window)即可。

# 升级前请查看当前系统版本号，执行以下命令

cd /www/wwwroot/mochat
php bin/hyperf.php mochat:version

# 记录下当前版本号，如果不是版本 1.3.2，后面需要注意升级多次

# 备份原有配置文件和数据库

备份以下配置文件：
- api-server/.env
- dashboard/.env
- sidebar/.env
- operation/.env
如果使用本地存储文件，刚备份文件上传目录
- api-server/storage/upload
备份 MySQL 数据库

# 将原代码目录改名

mv /www/wwwroot/mochat /www/wwwroot/mochat_old

# 下载新的代码并重新安装依赖

# cd /www/wwwroot
# 此步如果是商业版，请将以下地址改为 gitee 私有地址
# git clone https://github.com/mochat-cloud/mochat.git
# cd /www/wwwroot/mochat/api-server
# composer install

# 将备份的api-server/.env复制过来
# cp /www/wwwroot/mochat_old/api-server/.env .env

# 如果是本地存储文件，将上传文件复制过来
# cp -R /www/wwwroot/mochat_old/api-server/storage/upload ./storage/

# 执行升级脚本

# 未二次开发过可以直接执行
# 如果二次开发过，增加过菜单，改过 mc_rbac_menu 表的，请自行对照升级SQL改为自己的升级SQL。
# 如果当前版本号是 1.3.2 请直接执行下面的命令
# php bin/hyperf.php mochat:upgrade 1.4.0

# 如果当前版本号不是 1.3.2 请执行升级中间的版本
# php bin/hyperf.php mochat:upgrade 1.2.0
# php bin/hyperf.php mochat:upgrade 1.2.1
# php bin/hyperf.php mochat:upgrade 1.3.0
# php bin/hyperf.php mochat:upgrade 1.3.1
# php bin/hyperf.php mochat:upgrade 1.3.2
# php bin/hyperf.php mochat:upgrade 1.4.0

# 配置自建应用代开发相关参数

参考文档

# 启动服务

cd /www/wwwroot/mochat/api-server
cp /www/wwwroot/mochat_old/api-server/.env .env
# 如果旧版服务未停止，可以使用下面的命令停止旧的api-server
ps aux | grep mochat |  awk '{print $2}' | xargs kill -9
# 加-d表示守护进程方式启动
php bin/hyperf.php server:start -d

# 依次配置各前端

租户后台前端重新编译

# 复制备份的配置文件
cd /www/wwwroot/mochat/dashboard
cp /www/wwwroot/mochat_old/dashboard/.env .env
yarn install
yarn build

侧边栏前端重新编译

# 复制备份的配置文件
cd /www/wwwroot/mochat/sidebar
cp /www/wwwroot/mochat_old/sidebar/.env .env
yarn install
yarn build

运营工具前端编译

# 复制备份的配置文件
cd /www/wwwroot/mochat/operation
cp /www/wwwroot/mochat_old/operation/.env .env
yarn install
yarn build

# 配置新增移动工作台

移动工具台前端编译

# 复制备份的配置文件
cd /www/wwwroot/mochat/workbench
yarn install
yarn build

移动工作台增加nginx配置

server {
    listen 80;
    server_name workbench.mochat.com;

    access_log /var/log/nginx/workbench.mochat.com.log main;
    error_log /var/log/nginx/workbench.mochat.com.log.err error;
    fastcgi_intercept_errors off;
    rewrite_log off;

    location / {
        root /www/wwwroot/mochat/workbench/dist;
        index index.html;
        try_files $uri $uri/ /index.html;
    }

    # 企业微信txt自动验证
    location ^~ /WW_verify_ {
        proxy_pass http://127.0.0.1:9501;
    }

    location = /favicon.ico {
            log_not_found off;
            access_log off;
    }
    
}

api-server/.env中增加移动工作台的URL

WORKBENCH_BASE_URL=https://workbench.mo.chat

# 新增加的环境变量配置汇总

其中api-server/.env中新增加了一些环境变量

SERVER_IP 为会话存档白名单IP使用，请填写为服务器公网IP，多个请用英文逗号分隔

# 工作台URL
WORKBENCH_BASE_URL=https://workbench.mo.chat

# 企业微信服务商配置
WEWORK_PROVIDER_CORP_ID=wwbced65cxxx
WEWORK_PROVIDER_SECRET=E-7Ldqs8jXxxxxxx
WEWORK_PROVIDER_TOKEN=wy57mHQSxx
WEWORK_PROVIDER_AES_KEY=py6g5MP6GBDd1xxx

# 企业微信自建应用代开发模板
WEWORK_APP_TEMPLATE_ID=dk97d8950xxx
WEWORK_APP_TEMPLATE_SECRET=Fx3fakdZhxxx
WEWORK_APP_TEMPLATE_TOKEN=ahfnIpIR2syx
WEWORK_APP_TEMPLATE_AES_KEY=KSYbqjLSuJxxxx

# 服务器IP，多个用,号分隔
SERVER_IP=23.34.33.138,33.34.38.120

# 消息会话存档定时同步间隔时间，单位秒
MESSAGE_SYNC_INTERVAL=15

← 插件开发示例 1.3 升级指南 →