fastadmin:目录结构与mvc请求流程

第 02 章 目录结构与 MVC 请求流程

fastadmin/
├── application/      # 应用目录(核心开发目录)
├── extend/           # 扩展类库
├── public/           # Web 入口目录(域名应指向这里)
│   ├── assets/       # 前端静态资源
│   ├── uploads/      # 上传文件
│   └── index.php     # 入口文件
├── runtime/          # 运行时缓存(需可写)
├── thinkphp/         # ThinkPHP 5 框架核心
└── vendor/           # Composer 依赖

FastAdmin 在 application 下划分了三个应用模块:

应用 用途 访问入口
admin 管理后台 /admin
index 前台页面 / 或 /index
api RESTful 接口 /api

每个应用内部都是经典的 MVC 结构:

application/admin/
├── controller/   # 控制器:接收请求、调用模型、返回视图或 JSON
├── model/        # 模型:数据表操作与业务逻辑
├── view/         # 视图:HTML 模板(基于 Think 模板引擎)
├── lang/         # 语言包
├── validate/     # 验证器
└── library/      # 本应用私有类库

以访问 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

所有后台控制器都继承 app\common\controller\Backend,它提供了:

  • $this->request:请求对象
  • $this->auth:当前登录管理员与权限对象
  • $this->success() / $this->error():统一 JSON 返回
  • $this->view->assign():向视图传参
  • 默认表前缀 fa_,安装时可自定义
  • CRUD 生成器依赖注释生成字段名称,建表时务必为每个字段写中文注释
  • 建议包含通用字段:createtime、updatetime(int 时间戳)、status、weigh(权重,越大越靠前)
  • application/config.php:主配置
  • application/database.php:数据库连接
  • application/extra/site.php:站点配置(后台系统配置写入此文件)
  • application/extra/addons.php:插件注册配置(安装插件时自动更新)

掌握三端划分与请求流程后,就能定位任意功能的代码位置。下一章进入实战:用一键 CRUD 生成第一个业务模块。

该主题尚不存在

您访问的页面并不存在。如果允许,您可以使用创建该页面按钮来创建它。

  • fastadmin/目录结构与mvc请求流程.txt
  • 最后更改: 2026/08/19 11:32
  • 由 张叶安