# 开发者必看

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)