# 1.4 升级指南

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

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

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

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