RdscodeAdmin快速开发系统

# 安装

# 部署环境要求

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

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. 获取并解压源码
    • 将下载的 RdscodeAdmin 源码包解压到任意目录
  2. 配置数据库
    • 在本地MySQl中创建数据库
    • 重命名源码包中的 .example.env 文件为 .env
    • 修改文件中DATABASE，USERNAME，PASSWORD
    • 导入源码根目录下data.sql文件到数据库
  3. 安装后端依赖
    • 因jwt版本升级，需要打开php扩展：sodium ext.png
    • 在源码根目录执行命令:
    // 执行安装时注意查看提示信息，根据提示信息调整系统配置 
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即可

快速开始 →