【亲测免费】 FastAPI-template 项目教程

1. 项目目录结构及介绍

项目FastAPI-template的目录结构如下：

.
├── app                  # 应用代码主目录
│   ├── main.py          # 启动文件
│   └── ...
├── config               # 配置文件目录
│   ├── config.py        # 全局配置
│   └── development.py   # 开发环境配置
├── requirements.txt     # 依赖包列表
└── ...

• app: 包含应用的核心代码，main.py是入口点，用于创建并运行FastAPI实例。
• config: 存放各种环境下的配置文件，如全局配置config.py和开发环境配置development.py。
• requirements.txt: 列出项目所需的Python包及其版本。

2. 项目的启动文件介绍

main.py

app/main.py是FastAPI应用的启动文件，它定义了路由、模型和其他关键组件。下面是一些关键部分的简介：

from fastapi import FastAPI
from .dependencies import auth_bearer
from .routers import router

app = FastAPI()

app.include_router(router, dependencies=[auth_bearer()])

• FastAPI() 初始化FastAPI实例。
• include_router() 方法引入子路由器router，这通常包含了应用程序的不同功能模块。
• dependencies 参数用于设置路由中间件，例如上面的auth_bearer() 可能是一个身份验证处理函数。

3. 项目的配置文件介绍

config.py

全局配置文件config.py通常包含可应用于任何环境的基本设置。例如：

class Config:
    SECRET_KEY = 'your_secret_key'
    DATABASE_URL = 'postgresql://user:password@localhost/dbname'
    ALGORITHM = 'HS256'
    ACCESS_TOKEN_EXPIRE_MINUTES = 30

这里的配置项包括秘钥、数据库连接URL、JWT算法和访问令牌的有效期。

development.py

开发环境配置文件允许覆盖config.py中的默认值，以适应本地开发的需求。例如：

from .config import Config

class DevelopmentConfig(Config):
    DEBUG = True
    DATABASE_URL = "postgresql:///dev_db"

这里启用了调试模式（DEBUG=True）并指定了一个不同的数据库URL供开发环境使用。

在实际项目中，你可以根据需要创建更多的配置文件，比如生产环境配置（production.py），并在不同环境下加载相应的配置。

通过了解上述目录结构、启动文件和配置文件，你应该能够更好地理解FastAPI-template项目的基础架构并开始进行自定义开发。记得在修改配置或添加新功能时遵循这些组织原则，以保持项目清晰和易于维护。