BuildAdmin

# 开发者必看

TIP

若您已经安装好系统，并准备开始二次开发或体验CRUD、终端等对代码会有变更的操作，我们建议您首先阅读本文档。
本文值得仔细研究理解，以免您缺乏基本概念或开发使用的方式方法错误。

# 开发环境

  1. 建议您在本地PC上安装好 BuildAdmin 系统，作为开发环境。
  2. 建议您全程使用php think run命令启动的服务来进行开发工作，可以选择不开启Nginx、Apache之类的服务器软件，参启动安装服务 (opens new window)
  3. 在安装 BuildAdmin 时您已经填写了系统的数据库资料，需要开启对应的数据库服务，数据库资料被保存在config/database.php文件。
  4. 在/web目录内，执行npm run dev命令，在浏览器打开localhost:1818 (opens new window)，域名一定是localhost（后端已配置它允许跨域）。
  5. 开发时，建议开启TP框架的调试模式：找到网站根目录的.env-example重命名为.env。参：开启调试模式 (opens new window)。

以上五步曲之后，您修改前端代码，localhost:1818的页面会热更新，方便您实时调试。并且api请求会有具体报错信息，CRUD代码生成后，立马就可以看到效果等，接下来，您可以开始查阅进阶文档 (opens new window)。

WARNING

开发环境执行了两个命令，站点端口是1818，接口会响应详细报错消息，并与Nginx、Apache无关，提问前请先判断好自己的环境。

# 线上环境（生产环境）

  1. 建议删除/install目录。
  2. 线上环境可以选择不上传/web目录，前端每次重新发布后，只将/public/assets 目录和/public/index.html 文件，同步到服务器上即可。
  3. 使用Nginx、Apache等服务器软件运行站点，而不再是php think run，请把BuildAdmin当做常规站点，站点的根目录配置为buildadmin目录，站点运行目录为buildadmin/public，如无运行目录配置项，请直接将根目录配置为buildadmin/public。
  4. 配置URL重写规则 (opens new window)
  5. 可以选择配置：隐藏index.html (opens new window)。

# 常见问题

# 为什么开发环境一定是使用php think run启动的服务，而不是Nginx或其他

  • 该服务通过执行一条命令启动，在执行这条命令时，我们能够读取到当前的环境变量，以此来实现WEB终端的命令执行功能，这条命令启动了站点的服务端(API服务)。

# web目录下执行npm run dev的意义？

  • vue项目不同于传统js、jQuery项目，开发者所有的改动是需要编译的（工程化）；而该命令启动了Vite的热更新服务，热更新服务可以实现：开发环境下无需编译快速查看修改效果，执行该命令后打开的localhost:1818，就是具备热更新、热重载等功能的开发专用站点。

# 每次改动都需要重新发布？

  • 错误。如以上的第2点所描述，只需要启动热更新服务进行开发工作即可，只在开发工作完成将要上线时，才进行重新发布。

← 贡献代码 →