FastAPI 和 fastapi-amis-admin：强大而可扩展的后台管理解决方案！
FastAPI 和 fastapi-amis-admin：强大而可扩展的后台管理解决方案！
我们都知道 Django 生态丰富，功能强大，适用于中、大型项目，并且自带了后台管理系统；而 FastAPI 更适用于构建高性能的 API，后台管理系统需要另外开发
本篇文章将介绍 FastAPI 结合 fastapi-amis-admin 快速搭建后台管理系统的步骤
fastapi-amis-admin 是一款高性能、高效且易于扩展的 FastAPI 管理框架；它受到 django-admin 的启发，拥有与 django-admin 一样多的强大功能
项目地址：
https://github.com/amisadmin/fastapi-amis-admin
1、安装依赖
# 1、更新pip
python3 -m pip install --upgrade pip
# 2、安装依赖fastapi_amis_admin
pip install fastapi_amis_admin
# 3、安装数据库管理依赖
# sqlite
pip install aiosqlite
# mysql
pip install aiomysql 需要注意的是，fastapi-amis-admin 对 Python 最低兼容版本为 Python3.7，如果安装了低版本，需要先更新版本
2、基础使用
这里以 sqlite 和 mysql 为例
sqlite：保存在本地
mysql：连接远程数据库
首先，创建一个 AdminSite 对象，指定数据库连接信息
然后，创建数据模型对象（继承于 SQLModel）映射数据库中的某张表，定义表名及表字段，配置到后台管理（继承于 ModelAdmin）中去
PS：如果数据库中已经存在表，就直接使用；如果不存在，就创建一张新的表
接着，创建一个 FastAPI 应用，使用 AdminSite 对象进行挂载
最后，在初始化事件方法中初始化数据库表
from fastapi import FastAPI
from sqlmodel import SQLModel
from fastapi_amis_admin.admin.settings import Settings
from fastapi_amis_admin.admin.site import AdminSite
from fastapi_amis_admin.admin import admin
from fastapi_amis_admin.models.fields import Field
# 创建FastAPI应用
app = FastAPI()
# 创建AdminSite实例
# sqlite（默认）
# site = AdminSite(settings=Settings(database_url_async='sqlite+aiosqlite:///amisadmin.db'))
# Mysql
# username：数据库配置信息（用户名）
# password：数据库配置信息（密码）
# ip：数据库配置信息（ip地址）
# port：数据库配置信息（数据库端口号）
# dbname：数据库配置信息（数据库名）
site = AdminSite(settings=Settings(database_url_async='mysql+aiomysql://username:password@ip:port/dbname'))
# 先创建一个SQLModel模型，映射数据库中的表
class Category(SQLModel, table=True):
id: int = Field(default=None, primary_key=True, nullable=False)
name: str = Field(title='CategoryName')
description: str = Field(default='', title='Description')
# 注册ModelAdmin
@site.register_admin
class CategoryAdmin(admin.ModelAdmin):
page_schema = '分类管理'
# 配置管理模型
model = Category
# 挂载后台管理系统
site.mount_app(app)
# 创建初始化数据库表
@app.on_event("startup")
async def startup():
await site.db.async_run_sync(SQLModel.metadata.create_all, is_session=False)
if __name__ == '__main__':
import uvicorn
uvicorn.run(app, debug=True)3、用户认证及权限配置
通过上面的步骤，我们发现后台管理系统缺少用户认证及权限配置
这里推荐使用 FastAPI-User-Auth
项目地址：
https://github.com/amisadmin/fastapi-user-auth
FastAPI-User-Auth 是一个简单而强大的 FastAPI 用户 RBAC 认证授权库，基于 FastAPI-Amis-Admin，可以提供可自由扩展的可视化管理界面
我们需要先安装依赖
# 用户认证权限
pip3 install fastapi-user-auth
我们接着对上面的代码进行修改（仅需 3 步）
首先，将 AdminSite 替换为其子类 AuthAdminSite，创建一个后台管理授权对象
from fastapi_user_auth.site import AuthAdminSite
# 实例化后台管理授权对象
site = AuthAdminSite(settings=Settings(database_url_async='mysql+aiomysql://username:password@ip:port/dbname'))
auth = site.auth然后，根据创建的 SQLModel 对象，注册 ModelAdmin
from fastapi_amis_admin.admin import admin
# 自定义Model
# 表名：custom_model
class CustomModel(SQLModel, table=True):
__tablename__ = 'custom_model'
id: int = Field(primary_key=True, nullable=False, unique=True)
name: str = Field(title="名称", max_length=100)
url: str = Field(max_length=1000, title="URL地址")
# 注册ModelAdmin
@site.register_admin
class CustomAdmin(admin.ModelAdmin):
page_schema = '自定义表'
model = CustomModel
最后，在初始化事件中初始化数据库表的同时，创建一个默认的管理员
PS：默认的管理员账号密码是 admin/admin，可以自行修改密码或者创建账号及权限设置
from fastapi_amis_admin.admin import admin
# 创建初始化数据库表
@app.on_event("startup")
async def startup():
await site.db.async_run_sync(SQLModel.metadata.create_all, is_session=False)
await auth.create_role_user(role_key='admin')4、部署问题
在部署到服务器时，可能会遇到 urllib3 不兼容的问题，我们只需要安装特定版本的 urllib3 即可
# 可能遇到的问题
urllib3 v2.0 only supports OpenSSL 1.1.1+, currently the 'ssl' module is compiled with OpenSSL 1.0.2k-fips 26 Jan 2017.
# 解决方案
# 安装urllib特定版本
pip3 install urllib3==1.26.6推荐阅读