基于 Django 框架搭建 WebAPI 项目实战
一、创建 Django 项目
在开始之前,确保你的 Python 环境已安装 Django。如果尚未安装,可以直接通过 pip 进行初始化:
pip install django
接着创建一个新项目目录,这里我们命名为 myproject:
django-admin startproject myproject
cd myproject
进入项目根目录后,我们需要添加一个具体的应用模块,比如叫 myapp:
python manage.py startapp myapp
此时项目结构已经成型,接下来需要引入第三方库来支持 RESTful API 开发。
二、安装相关依赖
构建标准的 WebAPI 通常需要处理序列化、认证和文档生成。除了基础的 Django,建议安装以下核心包:
pip install djangorestframework mysqlclient redis drf-yasg djangorestframework-simplejwt
djangorestframework(DRF):提供强大的 API 视图和序列化器。mysqlclient:用于连接 MySQL 数据库。redis:作为缓存中间件或会话存储。drf-yasg:自动生成 Swagger/OpenAPI 文档。djangostframework-simplejwt:实现 JWT 令牌认证。
三、配置 MySQL 数据库
打开 settings.py,找到 DATABASES 配置项。将默认的 SQLite 替换为 MySQL 驱动,并填入实际的环境信息。注意密码中若包含特殊字符,需进行 URL 编码处理。
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.mysql',
'NAME': 'your_database_name',
'USER': 'your_username',
'PASSWORD': 'your_password',
'HOST': 'localhost',
'PORT': '3306',
}
}
配置完成后,记得执行迁移命令以创建数据库表结构:
python manage.py migrate
四、配置 Redis 缓存
Redis 能显著提升接口响应速度。在 settings.py 的 CACHES 中添加 Redis 后端配置:
CACHES = {
: {
: ,
: ,
: {
: ,
}
}
}


