二次开发部署

#概述

本文将针对 Discuz! Q 二次开发的开发环境及代码部署进行说明。

#环境配置

开发环境使用 Nginx 1.18.0 、PHP 7.3.23 、CentOS 7.6 版本为例。详情参见：基于手动配置的 Nginx 环境。

#代码部署

Discuz! Q 开源主仓库共有4个，若要 fork 仓库进行手动部署，则需要组合四个仓库的代码。详情如下：

  1. Discuz-Q: git@gitee.com:Discuz/Discuz-Q.git #Discuz! Q 后端主程序
  2. Discuz-Q-Framework: git@gitee.com:Discuz/Discuz-Q-Framework.git #Discuz! Q后端抽象类程序
  3. Discuz-Q-uniapp: git@gitee.com:Discuz/Discuz-Q-uniapp.git #Discuz! Q H5及小程序代码
  4. Discuz-Q-Web: git@gitee.com:Discuz/Discuz-Q-Web.git #Discuz! Q PC端代码

首次部署执行以下命令：

  1. git clone git@gitee.com:Discuz/Discuz-Q.git dzq-dev
  2. cd dzq-dev
  3. git clone git@gitee.com:Discuz/Discuz-Q-Framework.git 
  4. framework

在dzq-dev 目录中新增public_1 与public_2两个文件夹，并在设置如下值：

  • public_1 中新增skin.conf 文件并写入1 值到文件中。
  • public_2 中新增skin.conf 文件并写入2 值到文件中。

TIP

安装项目依赖前必须安装 composer ,您可以使用命令composer install 进行安装。

使用cd ../ 回到dzq-dev 同级目录，使用clone 命令拉取前端代码。

  1. git clone git@gitee.com:Discuz/Discuz-Q-uniapp discuz-uniapp
  2. git clone git@gitee.com:Discuz/Discuz-Q-Web.git discuz-web

TIP

以下的脚本执行需要安装 npm 环境。

把以下脚本内容复制到 back.sh 文件中。

  1. #!/bin/bash
  2. export PATH=$PATH:/usr/local/bin
  4. BASE="$( cd "$( dirname "${BASH_SOURCE[0]}" )" >/dev/null 2>&1 && pwd )"
  6. cd $BASE/dzq-dev
  7. git pull origin master
  9. cd $BASE/dzq-dev/framework
  10. git pull origin master
  12. cd $BASE/dzq-dev/resources/frame
  14. npm install
  15. npm run build-admin
  16. npm run build-admin:pay
  18. rm -rf $BASE/dzq-dev/public_2/static-admin
  19. cp -r $BASE/dzq-dev/public_pay/* $BASE/dzq-dev/public_2/ 
  21. rm -rf $BASE/dzq-dev/public_1/static-admin
  22. cp -r $BASE/dzq-dev/public/static-admin $BASE/dzq-dev/public_1/
  23. cp $BASE/dzq-dev/public/admin.html $BASE/dzq-dev/public_1/

把以下脚本内容复制到 H5.sh 文件中。

  1. #!/bin/bash
  2. export PATH=$PATH:/usr/local/bin
  4. BASE="$( cd "$( dirname "${BASH_SOURCE[0]}" )" >/dev/null 2>&1 && pwd )"
  6. cd $BASE/discuz-uniapp
  7. git pull origin master
  9. npm install
  10. echo ============build h5====================
  11. npm run build:h5
  12. echo ============build h5 play===============
  13. npm run build:h5-play
  15. echo =============delete static====================
  16. rm -rf $BASE/dzq-dev/public/static 
  17. rm -rf $BASE/dzq-dev/public_1/static
  18. rm -rf $BASE/dzq-dev/public_2/static
  20. echo ============copy dist to public===============
  21. cp -r $BASE/discuz-uniapp/dist/build/h5/* $BASE/dzq-dev/public/ 
  22. cp -r $BASE/discuz-uniapp/dist/build/h5/* $BASE/dzq-dev/public_1/
  23. cp -r $BASE/discuz-uniapp/dist/build/h5-play/* $BASE/dzq-dev/public_2/

把以下脚本内容复制到 pc.sh 文件中。

  1. #!/bin/bash
  2. export PATH=$PATH:/usr/local/bin
  4. BASE="$( cd "$( dirname "${BASH_SOURCE[0]}" )" >/dev/null 2>&1 && pwd )"
  5. cd $BASE/discuz-web/
  6. git pull origin master
  8. npm install
  9. npm run build:spa
  10. rm -rf $BASE/dzq-dev/public/invite 
  11. rm -rf $BASE/dzq-dev/public/manage
  12. rm -rf $BASE/dzq-dev/public/modify
  13. rm -rf $BASE/dzq-dev/public/my
  14. rm -rf $BASE/dzq-dev/public/_nuxt
  15. rm -rf $BASE/dzq-dev/public/site
  16. rm -rf $BASE/dzq-dev/public/thread
  17. rm -rf $BASE/dzq-dev/public/topic
  18. rm -rf $BASE/dzq-dev/public/user
  19. mv dist/index.html dist/pc.html
  20. cp -r $BASE/discuz-web/dist/* $BASE/dzq-dev/public/
  21. rm -rf $BASE/dzq-dev/public_1/invite
  22. rm -rf $BASE/dzq-dev/public_1/manage
  23. rm -rf $BASE/dzq-dev/public_1/modify
  24. rm -rf $BASE/dzq-dev/public_1/my
  25. rm -rf $BASE/dzq-dev/public_1/_nuxt
  26. rm -rf $BASE/dzq-dev/public_1/site
  27. rm -rf $BASE/dzq-dev/public_1/thread
  28. rm -rf $BASE/dzq-dev/public_1/topic
  29. rm -rf $BASE/dzq-dev/public_1/user
  30. cp -r $BASE/discuz-web/dist/* $BASE/dzq-dev/public_1/
  31. rm -rf $BASE/discuz-web/dist
  32. cd $BASE/discuz-web/
  33. npm run build:pay-spa
  34. rm -rf $BASE/dzq-dev/public_2/invite
  35. rm -rf $BASE/dzq-dev/public_2/manage
  36. rm -rf $BASE/dzq-dev/public_2/modify
  37. rm -rf $BASE/dzq-dev/public_2/my
  38. rm -rf $BASE/dzq-dev/public_2/_nuxt
  39. rm -rf $BASE/dzq-dev/public_2/site
  40. rm -rf $BASE/dzq-dev/public_2/thread
  41. rm -rf $BASE/dzq-dev/public_2/topic
  42. rm -rf $BASE/dzq-dev/public_2/user
  43. mv dist/index.html dist/pc.html
  44. cp -r $BASE/discuz-web/dist/* $BASE/dzq-dev/public_2/
  45. rm -rf $BASE/discuz-web/dist

把以上三个脚本文件back.sh、H5.sh、pc.sh 放置与dzq-dev 文件同级目录下，并分别执行：

  1. sh back.sh
  2. sh H5.sh
  3. sh pc.sh

构建并组合好所有的代码后，需使用git clone git@gitee.com:Discuz/Discuz-Q-Update.git 下载命令执行文件。

TIP

若无权限，则需要从官方提供的安装包中，安装包/app/Console/Commands/Upgrades/ 目录下复制所有的文件到项目目录/app/Console/Commands/Upgrades/下。

此处就已完成全部代码整合，配置好 Nginx 服务后访问https://域名/install 即可安装站点。

WARNING

首次安装后，再次升级时，只需要执行back.sh、pc.sh、H5.sh即可。数据迁移查看每个版本的命令，详情参见：手动升级方式。