十七 Django-用户模块

一、概要

auth模块是Django提供的标准权限管理系统,可以提供用户身份认证, 用户组和权限管理。

auth可以和admin模块配合使用， 快速建立网站的管理系统。

在INSTALLED_APPS中添加'django.contrib.auth'使用该app, auth模块默认启用。

主要的操作包括:

  1. create_user 创建用户
  2. authenticate 验证登录
  3. login 记住用户的登录状态
  4. logout 退出登录
  5. is_authenticated 判断用户是否登录
  6. @login_required 判断用户是否登录的装饰器

二、前期配置

1、说明

Django 在新建工程时已经为使用用户认证系统做好了全部必要的配置。不过有可能你并非使用 django-admin 命令新建的工程，或者你使用的是一个正在开发中的项目，因此最好再检查一下 settings.py 文件中是否已经做好了全部必要配置。

2、配置

  1. 在setting.py的INSTALLED_APPS 
    INSTALLED_APPS = [
    'django.contrib.auth',   
    # 用户权限处理部分依赖的应用    
    'django.contrib.contenttypes',
]
  2. 在setting.py的MIDDLEWARE 
    MIDDLEWARE = [
# 会话支持中间件
'django.contrib.sessions.middleware.SessionMiddleware',
# 认证支持中间件
'django.contrib.auth.middleware.AuthenticationMiddleware',
]
  3. 在项目下面的urls.py中 
    urlpatterns = [
    url(r'^admin/', admin.site.urls),
    # 首页
    url(r'^$', views.index, name='index')
    # 将 auth 应用中的 urls 模块包含进来
    url(r'^users/', include('django.contrib.auth.urls')),
]

三、User对象

1、user对象

  1. 属性
    说明 说明 备注
    username 少于等于30个字符。 用户名可以包含字母、数字、_、@、+、.和- 字符 必选
    first_name 少于等于30个字符 可选
    last_name 少于30个字符 可选
    email 邮箱地址 可选
    password 密码的哈希及元数据。（Django 不保存原始密码）。原始密码可以无限长而且可以包含任意字符。参见密码相关的文档 必选
    groups 与Group 之间的多对多关系 可选
    user_permissions 与Permission 之间的多对多关系 可选
    is_staff 布尔值。指示用户是否可以访问Admin 站点 可选
    is_active 布尔值。指示用户的账号是否激活 必选
    is_superuser 布尔值。只是这个用户拥有所有的权限而不需要给他们分配明确的权限。 可选
    last_login 用户最后一次登录的时间 默认值
    date_joined 账户创建的时间。当账号创建时，默认设置为当前的date/time 默认值
  2. 说明
    User 对象属性：username， password（必填项）password用哈希算法保存到数据库
    is_staff ： 用户是否拥有网站的管理权限.
    is_active ： 是否允许用户登录, 设置为False，可以不用删除用户来禁止 用户登录

2、拓展 User 模型

2.1、说明

用户可能还包含有头像、昵称、介绍等等其它属性，因此仅仅使用 Django 内置的 User 模型是不够。所有有些时候我们必须使用在系统的User上进行拓展

2.2、继承AbstractUser (方式一)

  1. 说明
    推荐方式、django.contrib.auth.models.User 也是继承自 AbstractUser 抽象基类，而且仅仅就是继承了 AbstractUser，没有对 AbstractUser 做任何的拓展
  2. 在app的models.py中 
    class User(AbstractUser):
    # 昵称
    nickname = models.CharField(max_length=50, blank=True)
    # 头像
 head = models.ImageField(max_length=50)
    class Meta(AbstractUser.Meta):
        db_table='user'
        pass
  3. 注意
    为了让 Django 用户认证系统使用我们自定义的用户模型，必须在 settings.py 里通过 AUTH_USER_MODEL 指定自定义用户模型所在的位置 
    AUTH_USER_MODEL = '模块.User'
  4. 迁移 
    python manage.py makemigrations
python manage.py migrate

3、使用 Profile 模式(方式二)

  1. 说明
    如果想为一个已使用了 Django 内置 User 模型的项目拓展用户模型，上述继承 AbstractUser 的拓展方式会变得有点麻烦。Django 没有提供将内置的 User 迁移到自定义的用户模型，因为 Django 已经为内置的 User 模型生成了相关数据库迁移文件和数据库表。如果非要这么做的话，需要手工修改迁移文件和数据库表，并且移动数据库中相关的用户数据。
  2. 示例代码 
    class UserProfile(models.Model):
    nickname = models.CharField(max_length=50, blank=True)
    desc = models.TextField(blank=True, null=True)
    user = models.OneToOneField(User)

    users = User.objects.all()
for user in users:
   print(user.userprofile.desc)

4、优缺点

  1. 继承 AbstractUser 的用户模型只有一张数据库表。
  2. 而 Profile 这种模式有两张表，一张是 User 模型对应的表，一张是 Profile 模型对应的表，两张表通过一对一的关系关联。可见，当要查询某个用户的 Profile 时，需要执行额外的跨表查询操作，所以这种方式比起直接承AbstractUser 效率更低一点。因此对于新项目来说，优先推荐使用继承 AbstractUser 的方式来拓展用户模型

3、 常用操作

1、验证登录

  1. 说明
    当用户登录的时候用authenticate(username=username,password=password)验证登录，判断数据库中是否存在用户输入的账号和密码，返回一个user对象。底层将password用hash算法加密后和数据库中password进行对比
  2. 示例代码

2、注册操作

  1. 说明
    当用户注册的时候用create_user(username,password,email)默认情况下is_active=True,is_staff=False,is_superuser=False。
    底层将password用hash算法加密之后存储到数据库中
  2. 示例代码 
    def register_view(request):
    if request.method == 'POST':
        try:
            username = request.POST.get('username')
            password = request.POST.get('password')
            phone = request.POST.get('phone')
            email = request.POST.get('email')
            # 验证用户是否存在
            user = authenticate(username=username, password=password)
            if user:
                # 用户已经存在
                return render(request, 'register.html', {'msg': '用户名已存在'})
            else:
                # 保存用户
                user = User.objects.create_user(username=username,
                                                password=password,
                                                phone=phone,
                                                email=email)
                # 将用户信息保存到session中
                login(request, user)
                return redirect('/')
        except Exception as e:
            return render(request, 'register.html', {'msg': '注册失败'})
    else:
        return render(request, 'register.html')

3、登录操作

  1. 说明
    当用户登录的时候用login(request,user)来记住用户的登录状态
    该函数接受一个HttpRequest对象，以及一个认证了的User对象
    此函数使用django的session框架给某个已认证的用户附加上session id等信息。
  2. 示例代码 
    def login_view(request):
    if request.method == 'POST':
        username = request.POST.get('username')
        password = request.POST.get('password')
         # 验证用户是否存在
        user = authenticate(request, username=username, password=password)
        if user:
             # 判断用户是否激活
            if user.is_active:
                login(request, user)
                return redirect('/')
            else:
                return render(request, 'test/login.html', {'msg': '用户尚未激活'})
        else:
            return render(request, 'test/login.html', {'msg': '用户密码错误'})
    else:
        return render(request, 'login.html')

4、登出操作

  1. 说明
    当用户注销的时候用logout(request),只需要一个参数request
  2. 示例代码 
    from django.contrib.auth import logout
def logout_view(request):
    logout(request)

5、修改密码

  1. 说明
  2. 示例代码 
    user = auth.authenticate(username=username, password=old_password)
if user:
    user.set_password(new_password)
    user.save()

6、只允许登录用户访问

  1. 说明
    @login_required 修饰器修饰的view函数会先通过session key检查是否登录,
    已登录用户可以正常的执行操作, 未登录用户将被重定向到login_url指定的位置. 若未指定login_url参数, 则重定向到settings.LOGIN_URL
  2. 示例代码 
    # settings 配置
LOGIN_URL = '/user/login/'
# views
@login_required
def find_user_info(request):
    pass

    @login_required(login_url='/accounts/login/')
def find_user_info(request):
 pass

7、验证登录

  1. 说明
    如果是真正的 User 对象，返回值恒为 True 。 用于检查用户是否已经通过了认证。 通过认证并不意味着用户拥有任何权限，甚至也不检查该用户是否处于激活状态，这只是表明用户成功的通过了认证。 这个方法很重要, 在后台用request.user.is_authenticated()判断用户是否已经登录，如果true则可以向前台展示request.user.name
  2. 示例代码 
    在后台的视图函数里可以用request.user.is_authenticated()判断用户是否登录
在前端页面中可以用
{% if user.is_authenticated %}
{% endif %}
判断用户是否登录
最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 199,393评论 5赞 467
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 83,790评论 2赞 376
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 146,391评论 0赞 330
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 53,703评论 1赞 270
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 62,613评论 5赞 359
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 48,003评论 1赞 275
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 37,507评论 3赞 390
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 36,158评论 0赞 254
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 40,300评论 1赞 294
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,256评论 2赞 317
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,274评论 1赞 328
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 32,984评论 3赞 316
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 38,569评论 3赞 303
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,662评论 0赞 19
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,899评论 1赞 255
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 42,268评论 2赞 345
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 41,840评论 2赞 339