Django 用户认证系统与数据模型集成实践
在 Django 中构建用户系统,核心在于利用其内置的认证框架(django.contrib.auth)。通过自定义模型扩展用户信息,并配置 Admin 后台,可以快速实现功能完备的后台管理与登录逻辑。
1. 数据模型与数据库迁移
Django 的模型系统通过 ORM 将数据库表抽象为 Python 类。创建一个新的应用(App)来管理自定义数据:
# 在终端执行
python manage.py startapp profiles
在 profiles/models.py 中定义业务模型,并将其添加到 settings.py 的 INSTALLED_APPS 中。完成模型定义后,执行迁移操作以同步至数据库:
python manage.py makemigrations
python manage.py migrate
常用的 ORM 查询操作示例:
# 数据存取操作
def save_data(request):
record = Record(title='Demo')
record.save()
return HttpResponse("操作成功")
# 查询与条件筛选
def query_data(request):
results = Record.objects.filter(active=True).order_by('-created_at')
return render(request, 'list.html', {'data': results})
2. Admin 后台定制
Django 提供了一个开箱即用的 Web 管理界面。首先通过 python manage.py createsuperuser 创建管理员账号,然后在 urls.py 中引入路径:
from django.contrib import admin
urlpatterns = [
path('admin/', admin.site.urls),
]
若需关联扩展用户信息(如关联内置 User 模型),可自定义 ModelAdmin 并使用 Inline 模式展示数据:
class ProfileInline(admin.StackedInline):
model = UserProfile
class UserAdminCustom(UserAdmin):
inlines = [ProfileInline]
admin.site.unregister(User)
admin.site.register(User, UserAdminCustom)
3. 实现用户登录逻辑
登录界面通过标准的 HTML 表单实现,必须包含 {% csrf_token %} 以确保安全性。视图函数通过 Django 的 authenticate 和 login 方法处理请求:
# views.py
from django.contrib.auth import authenticate, login
from django.shortcuts import render, redirect
def user_login(request):
if request.method == 'POST':
user = authenticate(
username=request.POST.get('username'),
password=request.POST.get('password')
)
if user:
login(request, user)
return redirect('dashboard')
return HttpResponse("登录失败")
return render(request, 'login.html')
配置 urls.py 路由时,建议使用 app_name 命名空间,以便在模板中通过 {% url 'profiles:login' %} 灵活生成链接。
4. 静态与媒体资源配置
在生产与开发环境切换中,需在 settings.py 中正确配置 STATIC_URL 和 MEDIA_URL。同时,在 urls.py 中添加对 MEDIA_ROOT 的映射,确保用户上传的文件(如头像)能通过 URL 正确访问:
from django.conf import settings
from django.conf.urls.static import static
if settings.DEBUG:
urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)