【教程】5. 搭建并熟悉 FastAdmin 框架

FastAdmin 是一款基于 ThinkPHP5 + Bootstrap 的极速后台开发框架。在 FastAdmin 中默认有四个应用模块：admin、api、common、index，你也可以扩展开发自己的应用模块。
后台模块 (admin) 是 FastAdmin 中的核心模块，后台模块又分为系统配置、附件管理、分类管理、插件管理等多个功能模块，更多的功能模块可以在插件管理中自由的安装和卸载。

① 下载fastadmin源码并运行
https://www.fastadmin.net/download.html

② 通读文档，了解框架基本结构
https://doc.fastadmin.net/doc/index.html

③ 根据数据库设计规范，自行设计一个涵盖多种字段类型的数据表
https://doc.fastadmin.net/doc/database.html

④ 利用一键生成命令，将设计好的数据表生成代码
https://doc.fastadmin.net/doc/crud.html

FastAdmin目录结构遵循ThinkPHP5官方建议的模块设计：

FastAdmin项目目录
├── addons //插件存放目录
├── application //应用目录
│ ├── admin //后台管理应用模块
│ ├── api //API应用模块
│ ├── common //通用应用模块
│ ├── extra //扩展配置目录
│ ├── index //前台应用模块
│ ├── build.php
│ ├── command.php //命令行配置
│ ├── common.php //通用辅助函数
│ ├── config.php //基础配置
│ ├── database.php //数据库配置
│ ├── route.php //路由配置
│ ├── tags.php //行为配置
├── extend
│ └── fast //FastAdmin扩展辅助类目录
├── public
│ ├── assets
│ │ ├── build //打包JS、CSS的资源目录
│ │ ├── css //CSS样式目录
│ │ ├── fonts //字体目录
│ │ ├── img
│ │ ├── js
│ │ │ ├── backend
│ │ │ └── frontend //后台功能模块JS文件存放目录
│ │ ├── libs //Bower资源包位置
│ │ └── less //Less资源目录
│ └── uploads //上传文件目录
│ ├── index.php //应用入口主文件
│ ├── install.php //FastAdmin安装引导
│ ├── admin.php //后台入口文件,强烈建议修改
│ ├── robots.txt
│ └── router.php
├── runtime //缓存目录
├── thinkphp //ThinkPHP5框架核心目录
├── vendor //Compposer资源包位置
├── .bowerrc //Bower目录配置文件
├── LICENSE
├── README.md
├── bower.json //Bower前端包配置
├── build.php
├── composer.json //Composer包配置
└── think

应用模块
在FastAdmin中默认有四个应用模块：admin、api、common、index，你也可以扩展开发自己的应用模块。

后台模块(admin)是FastAdmin中的核心模块，后台模块又分为系统配置、附件管理、分类管理、插件管理等多个功能模块，更多的功能模块可以在插件管理中自由的安装和卸载。

后台的前端是基于AdminLTE和Bootstrap进行了大量二次开发，采用RequireJS进行JS模块化管理和加载。

前台模块(index)的结构和后台功能类似，具体请参考后台模块的章节

公共模块(common)是一个特殊的模块，默认是禁止直接访问的，一般用于放置一些公共的类或其它模块的继承基类等。

Api模块(api)通常用于对接APP，用于向APP提供接口，目前FastAdmin暂未提供API相关的插件和文档，你可以直接参考ThinkPHP5官方的文档。

功能模块
功能模块指后台管理中的功能模块，比如我们的系统配置、附件管理、分类管理。

后台开发的每一个功能模块都是基于MVC的设计模式进行开发 。在FastAdmin中，我们提供了一键生成CRUD的功能，这个一键生成CRUD生成的文件也就是我们标准的MVC文件。

以下是一个标准的功能模块所涉及到的文件

├── application
│ └── admin
│ ├── controller
│ │ └── Test.php //控制器类
│ ├── lang
│ │ ├── zh-cn
│ │ │ └── test.php //功能语言包,按需加载
│ │ └── zh-cn.php //后台语言包,默认加载
│ ├── model
│ │ └── Test.php //模型类
│ ├── validate
│ │ └── Test.php //验证器类
│ └── view
│ └── test
│ ├── index.html //列表视图
│ ├── add.html //添加视图
│ └── edit.html //编辑视图
└── public
└── assets
└── js
└── backend
└── test.js //功能模块JS文件
在FastAdmin中每一个功能模块至少对应一个功能模块JS文件，也就是说每一个控制器都对应一个同名的JS文件，其次每一个控制器的方法对应JS文件中同名的方法。

开启调试模式的方法有两种：

1、打开application/config.php，找到app_debug,将它的值置为true即可

2、如果你有启用.env环境配置，修改其中app_debug的值为true即可。