# 第 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` 为例: 1. **入口**:`public/index.php` 加载 ThinkPHP 并启动应用 2. **路由**:URL 解析为 `模块/控制器/方法` → `admin/general/config/index` 3. **初始化**:`application/admin/library/Auth.php` 执行登录校验与权限检测 4. **控制器**:`app\admin\controller\general\Config` 的 `index()` 方法被调用 5. **模型**:控制器调用模型读取数据(如配置表 `fa_config`) 6. **视图**:加载 `application/admin/view/general/config/index.html` 渲染页面 7. **响应**:返回 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 生成第一个业务模块。