第 02 章 目录结构与 MVC 请求流程
2.1 顶层目录一览
fastadmin/ ├── application/ # 应用目录(核心开发目录) ├── extend/ # 扩展类库 ├── public/ # Web 入口目录(域名应指向这里) │ ├── assets/ # 前端静态资源 │ ├── uploads/ # 上传文件 │ └── index.php # 入口文件 ├── runtime/ # 运行时缓存(需可写) ├── thinkphp/ # ThinkPHP 5 框架核心 └── vendor/ # Composer 依赖
2.2 application 三大应用
FastAdmin 在 application 下划分了三个应用模块:
| 应用 | 用途 | 访问入口 |
admin | 管理后台 | /admin |
index | 前台页面 | / 或 /index |
api | RESTful 接口 | /api |
每个应用内部都是经典的 MVC 结构:
application/admin/ ├── controller/ # 控制器:接收请求、调用模型、返回视图或 JSON ├── model/ # 模型:数据表操作与业务逻辑 ├── view/ # 视图:HTML 模板(基于 Think 模板引擎) ├── lang/ # 语言包 ├── validate/ # 验证器 └── library/ # 本应用私有类库
2.3 一次请求的完整生命周期
以访问 admin/general/config 为例:
- 入口:
public/index.php加载 ThinkPHP 并启动应用 - 路由:URL 解析为
模块/控制器/方法→admin/general/config/index - 初始化:
application/admin/library/Auth.php执行登录校验与权限检测 - 控制器:
app\admin\controller\general\Config的index()方法被调用 - 模型:控制器调用模型读取数据(如配置表
fa_config) - 视图:加载
application/admin/view/general/config/index.html渲染页面 - 响应:返回 HTML;若为 AJAX 请求则返回 JSON
后台基类 Backend
所有后台控制器都继承 app\common\controller\Backend,它提供了:
$this->request:请求对象$this->auth:当前登录管理员与权限对象$this->success()/$this->error():统一 JSON 返回$this->view->assign():向视图传参
2.4 数据库表命名约定
- 默认表前缀
fa_,安装时可自定义 - CRUD 生成器依赖注释生成字段名称,建表时务必为每个字段写中文注释
- 建议包含通用字段:
createtime、updatetime(int 时间戳)、status、weigh(权重,越大越靠前)
2.5 配置文件
application/config.php:主配置application/database.php:数据库连接application/extra/site.php:站点配置(后台系统配置写入此文件)application/extra/addons.php:插件注册配置(安装插件时自动更新)
本章小结
掌握三端划分与请求流程后,就能定位任意功能的代码位置。下一章进入实战:用一键 CRUD 生成第一个业务模块。