# 安装

# 部署环境要求

Rds快速开发系统推荐部署的服务器环境

PHP     >=  7.4
MySQL   >=  5.6 支持innodb引擎
Apache 或者 Nginx

# 开发环境建议安装

Git         代码版本管理器
Node.js     JavaScript运行环境,安装Vue相关支持
Composer    PHP的包管理器
yarn        替代npm的依赖安装工具
apidoc      用于生成API文档的工具

# 本地开发教

因涉及安装PHP依赖和Vue依赖,配置比较复杂,初学者往往很难一次搞定,我们建议安装 集成开发环境laragon软件,因为通过安装此软件可以自动安装几乎所有您需要的软件。 img_5.png

  1. 检查环境要求
// 检查 php 版本
php --version
// 检查 composer
composer --version
// 检查 MySQL
mysql -V
// 检查 Git 可选 
git --version
// 检查 node.js 
node --version
// 检查 npm 
npm --version
// 检查 yarn 可选 
yarn -v
// 检查 apidoc
apidoc --version
  • 安装完成后检查安装的软件 img_6.png

  • 建议修改npm、composer镜像,已提高安装速度:

npm config set registry https://registry.npm.taobao.org
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
  • 建议修改npm的全局配置
npm config set prefix "c:\laragon\bin\nodejs\node_global"  # 全局模块插件存放路径
npm config set cache "c:\laragon\bin\nodejs\node_cache"    # 缓存路径
  • 将"c:\laragon\bin\nodejs\node_global"路径添加到环境变量PATH中 img_7.png

  • 安装yarn和apidoc

npm i yarn -G     // 安装yarn
npm i apidoc@0.50.5 -G   // 安装apidoc
  1. 获取并解压源码
    • 将下载的 Rds 源码包解压到任意目录
  2. 配置数据库
    • 在本地MySQl中创建数据库
    • 重命名源码包中的 .example.env 文件为 .env
    • 修改文件中DATABASE,USERNAME,PASSWORD
    • 导入源码根目录下data.sql文件到数据库
  3. 安装后端依赖
    • 因jwt版本升级,需要打开php扩展:sodium
    • 在源码根目录执行命令:
    // 执行安装时注意查看提示信息,根据提示信息调整系统配置 
    composer install
    
  4. 安装前端依赖
    • 在源码目录下的ui目录中执行命令:
    npm install 或者 yarn install
    
  5. 启动后端项目
    • 在源码根目录执行
     php think run
    
  6. 启动前端项目
    • 在源码目录下的ui目录中执行命令:
    npm run serve
    
  7. 开始开发
    • 项目的前后端启动完成后,会自动打开浏览器进入系统首页
    • 使用指定的用户名和密码进入系统,即可进行开发
  8. 准备部署
    • 清理测试数据,备份数据库
    • 在/ui目录下执行编译命令
    npm run build
    
    • 前端会自动编译到public/dist目录

# 服务器部署教程

以Linux版本的宝塔面板为例

  1. 进入宝塔系统,建立站点(包含数据库)
  2. 将下载的源码上传并解压到站点根目录
  3. 在站点列表中,点击网站名打开站点修改,设置网站根目录;将public目录设置为运行目录
  4. 在站点修改界面打开伪静态选项卡,选中 thinkphp
  5. 打开创建站点时创建的数据库,导入data.sql文件
  6. 根据数据库配置的数据库名、用户名、密码,修改网站源代码目录下config/database.php 文件

# 默认部署和自定义部署

  • 主题【服务器部署教程】中所属为默认的部署方式。这种部署方式,是把前端和后端服务都部署于同一台服务器。 如下图所示为文件ui/src/api/request.js内容;由文件内容可知,部署到生成环境的,后端服务接口地址为当前服务器。 img_8-1.png
  • 如下图所示为文件ui/vue.config.js内容;由文件内容可知,编译后的输出目录是public/dist目录, 所以,当我们部署到服务器时,前端编译结果就放到了Thinkphp项目的入口目录下的dist目录中了。所以 在这种情况下,只需要把项目放到单个主机空间中,访问http://domain/dist/即可访问项目; img_8-2.png
  • 如果您希望将前端和后端项目分别部署到不同的服务器,则可以通过适当修改即可实现。
    • 首先确定后端服务部署到什么域名(假设是服务端为:server.rdscode.cn;前端为:client.rdscode.cn)
    • 其次修改ui/src/api/request.js文件,将后端服务器的地址改为 http://server.rdscode.cn/admin img_8-3.png
    • 第三步:正常编译前端,分别将后端Thinkphp项目文件上传到 server.rdscode.cn 主机; 前端(public/dist目录中的内容)上传到 client.rdscode.cn 主机;
    • 访问此项目的时候访问:http://client.rdscode.cn即可