# 开发者必看
TIP
若您已经安装好系统,并准备开始二次开发或体验CRUD、终端等对代码会有变更的操作,我们建议您首先阅读本文档。
本文值得仔细研究理解,以免您缺乏基本概念或开发使用的方式方法错误。
# 开发环境
- 建议您在本地PC上安装好 BuildAdmin 系统,作为开发环境。
- 建议您全程使用
php think run
命令启动的服务来进行开发工作,可以选择不开启Nginx、Apache
之类的服务器软件,参启动安装服务 (opens new window) - 在安装 BuildAdmin 时您已经填写了系统的数据库资料,需要开启对应的数据库服务,数据库资料被保存在
config/database.php
文件。 - 在
/web
目录内,执行npm run dev
命令,在浏览器打开localhost:1818 (opens new window),域名一定是localhost
(后端已配置它允许跨域)。 - 开发时,建议开启TP框架的调试模式:找到网站根目录的
.env-example
重命名为.env
。参:开启调试模式 (opens new window)。
以上五步曲之后,您修改前端代码,localhost:1818
的页面会热更新,方便您实时调试。并且api请求会有具体报错信息,CRUD代码生成后,立马就可以看到效果等,接下来,您可以开始查阅进阶文档 (opens new window)。
WARNING
开发环境执行了两个命令,站点端口是1818
,接口会响应详细报错消息,并与Nginx、Apache
无关,提问前请先判断好自己的环境。
# 线上环境(生产环境)
- 建议删除
/install
目录。 - 线上环境可以选择不上传
/web
目录,前端每次重新发布后,只将/public/assets 目录
和/public/index.html 文件
,同步到服务器上即可。 - 使用
Nginx、Apache
等服务器软件运行站点,而不再是php think run
,请把BuildAdmin
当做常规站点,站点的根目录配置为buildadmin
目录,站点运行目录为buildadmin/public
,如无运行目录配置项,请直接将根目录配置为buildadmin/public
。 - 配置URL重写规则 (opens new window)
- 可以选择配置:隐藏index.html (opens new window)。
# 常见问题
# 为什么开发环境一定是使用php think run
启动的服务,而不是Nginx或其他
- 该服务通过执行一条命令启动,在执行这条命令时,我们能够读取到当前的
环境变量
,以此来实现WEB终端
的命令执行功能,这条命令启动了站点的服务端(API服务)
。
# web
目录下执行npm run dev
的意义?
vue
项目不同于传统js、jQuery
项目,开发者所有的改动是需要编译
的(工程化);而该命令启动了Vite
的热更新服务,热更新服务可以实现:开发环境下无需编译快速查看修改效果
,执行该命令后打开的localhost:1818
,就是具备热更新、热重载等功能的开发专用站点。
# 每次改动都需要重新发布
?
- 错误。如以上的第
2
点所描述,只需要启动热更新服务进行开发工作即可,只在开发工作完成将要上线时,才进行重新发布。