FastAPI与MongoDB集成项目教程

项目目录结构及介绍

fastapi-mongo/
├── app/
│   ├── __init__.py
│   ├── main.py
│   ├── models.py
│   ├── routes.py
│   └── settings.py
├── .env
├── .gitignore
├── README.md
└── requirements.txt

• app/: 包含项目的主要代码文件。
  • __init__.py: 初始化文件，使app目录成为一个Python包。
  • main.py: 项目的启动文件。
  • models.py: 定义MongoDB的数据模型。
  • routes.py: 定义API的路由。
  • settings.py: 项目的配置文件。
• .env: 存储环境变量，如数据库连接信息。
• .gitignore: 指定Git忽略的文件和目录。
• README.md: 项目说明文档。
• requirements.txt: 项目依赖的Python包列表。

项目的启动文件介绍

app/main.py 是项目的启动文件，主要包含FastAPI应用的实例化和路由的加载。

from fastapi import FastAPI
from app.routes import router

app = FastAPI()

app.include_router(router)

@app.get("/")
def read_root():
    return {"message": "Welcome to FastAPI with MongoDB!"}

• FastAPI() 实例化一个FastAPI应用。
• app.include_router(router) 加载定义在routes.py中的路由。
• @app.get("/") 定义了一个根路径的GET请求处理函数。

项目的配置文件介绍

app/settings.py 是项目的配置文件，主要包含数据库连接信息的加载和配置。

from pydantic import BaseSettings

class Settings(BaseSettings):
    mongo_uri: str
    database_name: str

settings = Settings(_env_file='.env', _env_file_encoding='utf-8')

• BaseSettings 是Pydantic提供的基类，用于环境变量的加载。
• Settings 类定义了需要加载的环境变量，如mongo_uri和database_name。
• settings 实例从.env文件中加载配置。

.env 文件示例：

MONGO_URI=mongodb://localhost:27017
DATABASE_NAME=fastapi_mongo

• MONGO_URI 是MongoDB的连接字符串。
• DATABASE_NAME 是数据库的名称。

以上是FastAPI与MongoDB集成项目的目录结构、启动文件和配置文件的介绍。希望对你有所帮助！