**这是本文档旧的修订版!**
第 01 章 认识 FastAdmin 与环境搭建
1.1 FastAdmin 是什么
FastAdmin 是一款基于 ThinkPHP 5 + Bootstrap 的开源 PHP 后台快速开发框架,目标是用最少的代码、最快的速度搭建功能完善的管理后台。
核心特性
| 特性 | 说明 |
| 一键 CRUD | 根据数据表一键生成控制器、模型、视图与 JS,秒级完成增删改查 |
| 插件体系 | Addons 插件机制,功能即插即用,官方市场有大量现成插件 |
| RBAC 权限 | 内置角色组-管理员-菜单规则三级权限控制,无需自行开发 |
| 前后端分离 | 内置 api 应用与 Token 鉴权,可同时输出 RESTful 接口 |
| 表格组件 | 基于 Bootstrap Table 封装,支持搜索、排序、导出、自定义按钮 |
| 表单组件 | Fieldlist 字段类型丰富,覆盖文本、富文本、上传、联动下拉等 |
适用场景
- 企业内部管理系统(CMS、CRM、OA)
- 需要快速验证 MVP 的创业产品后台
- 以 PHP 为后端、需要同时提供 H5/小程序 API 的项目
1.2 环境要求
- PHP >= 7.0(推荐 7.2~7.4,FastAdmin 基于 TP5 对 PHP 8 兼容性有限)
- MySQL >= 5.5
- Composer
- Web 服务器:Nginx 或 Apache
- 必需扩展:PDO、cURL、OpenSSL、Mbstring、Fileinfo
1.3 安装步骤
方式一:Composer 安装(推荐)
- snippet.bash
composer create-project karsonzhang/fastadmin fastadmin cd fastadmin
方式二:完整包安装
从官网或码云下载完整包,解压后将运行目录指向 public。
命令行安装
- snippet.bash
php think install -u 数据库用户名 -p 数据库密码
也可以直接访问站点,跟随可视化安装向导填写数据库信息。
1.4 伪静态配置
Nginx
Apache
public 目录下已自带 .htaccess,确保开启 mod_rewrite 即可。
1.5 首次登录后台
安装完成后访问 http://你的域名/admin,使用安装时设置的管理员账号登录。登录后建议立即完成:
- 修改默认管理员密码
- 在「常规管理 → 系统配置」中检查站点信息
- 确认「插件管理」可正常访问官方插件市场
1.6 常见问题
- 后台 404:伪静态未配置或运行目录未指向
public - install 锁定:删除
public/install.php之外的安装锁文件位于application/install.lock - 菜单不显示:清空缓存
php think clear,或在后台「系统 → 常规」重建菜单缓存
本章小结
本章完成了 FastAdmin 的安装与后台首次登录。下一章将解析目录结构与一次请求的完整流程,为后续 CRUD 开发打基础。