auth模块:
我们在开发一个网站的时候,无可避免的需要设计实现网站的用户系统。此时我们需要实现包括用户注册、用户登录、用户认证、注销、修改密码等功能,Django作为一个完美主义者的终极框架,当然也会想到这些。它内置了强大的用户认证系统--auth,它默认使用 auth_user 表来存储用户数据。
例如
以前手写的登录验证,是在登录成功后设置sesson[‘name’]=’max’,下次来的时候从cookie中取session_id然后去session表中找, 验证成功后写session['user'].使用了auth模块,login后会自动写session
导入:
from django.contrib import auth
from django.contrib.auth.models import User
auth提供的接口:
1. authenticate(username 、password) :验证账号密码是否正确
如果认证成功返回一个 User 对象。
authenticate()会在该 User 对象上设置一个属性来标识后端已经认证了该用户。
用法:
user_obj= auth.authenticate(request,username='theuser',password='thepassword')
2.login(HttpRequest, user)登录
用户登录。它本质上会在后端为该用户生成相关session数据。登录后 request.user=user_obj
用法:
user = authenticate(request, username=username, password=password)
if user is not None:
login(request, user)
redirest xxxx
else:
return xxx
3.logout(request)
当调用logout后当前请求的session信息会全部清除。本质是做了request.session.flush() 将session数据都删除,并且Cookie也失效
用法:
from django.contrib.auth import logout
def logout_view(request):
logout(request)
4.是否通过认证is_authenticated()
判断当前请求是否通过了认证。
用法:
def my_view(request):
if not request.user.is_authenticated():
return redirect('%s?next=%s' % (settings.LOGIN_URL, request.path))
5.@login_requierd():给视图添加登录认证
auth 给我们提供的一个装饰器工具,用来快捷的给某个视图添加登录校验。
用法:
from django.contrib.auth.decorators import login_required
@login_required
def my_view(request):...
若用户没有登录,则会跳转到django默认的 登录URL '/accounts/login/ ' 并传递当前访问url的绝对路径 (登陆成功后,会重定向到该路径)。
如果需要自定义登录的URL,则需要在settings.py文件中通过LOGIN_URL进行修改。
示例:
LOGIN_URL = '/login/' # 这里配置成你项目登录页面的路由
6.创建用户create_user():
from django.contrib.auth.models import User
user = User.objects.create_user(username='用户名',password='密码',email='邮箱',...)
7.创建超级用户create_superuser():
from django.contrib.auth.models import User
user = User.objects.create_superuser(username='用户名',password='密码',email='邮箱',...)
8.check_password(password) 检查密码是否正确:
检查密码是否正确的方法,需要提供当前请求用户的密码。
密码正确返回True,否则返回False。
用法:
ok = user.check_password('密码')
9.set_password(password):修改密码
修改密码的方法,接收 要设置的新密码 作为参数。
注意:设置完一定要调用用户对象的save方法!!!
用法:
user.set_password(password='xxx')
user.save()
User对象的属性:
username,
password
is_staff : 用户是否拥有网站的管理权限.
is_active : 是否允许用户登录, 设置为 False,可以在不删除用户的前提下禁止用户登录。
扩展默认的auth_user表
(使用djaong用户认证组件,前提必须使用djaong的用户表auth_user)
auth_user表字段都是固定的那几个,在项目中没法拿来直接使用 比如,我想要加一个存储用户手机号的字段,怎么办?
方法1: 新建另外一张表然后通过一对一和内置的auth_user表关联
这样虽然能满足要求但是还有更好的实现方式.
方法2: 自定义Model类
自定义Model类继承 AbstractUser 这样既能根据项目需求灵活的设计用户表,又能使用Django强大的认证系统了。
相当于对默认的auth_user表做了扩展, 并且代替auth_user
from django.contrib.auth.models import AbstractUser
class UserInfo(AbstractUser):
nid = models.AutoField(primary_key=True)
phone = models.CharField(max_length=11, null=True, unique=True)
def __str__(self):
return self.username
注意:
按上面的方式扩展了内置的auth_user表之后,一定要在settings.py中告诉Django: AUTH_USER_MODEL = "app名.UserInfo" , ↑↑
再次注意:
一旦我们指定了新的认证系统所使用的表,我们就需要重新在数据库中创建该表,而不能继续使用原来默认的auth_user表了。