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





作者:星安果


欢迎关注微信公众号 :AirPython