Django之博客系统：用户登陆

使用django有一个好处就是有各种各样的框架可以拿来直接使用。相比flask，django自带的框架确实要多很多。比如这一章就要介绍的用户登录。Django拥有一个内置的认证（authentication）框架用来操作用户认证（authentication），会话（sessions），权限（permissions）以及用户组。这个认证（authentication）系统包含了一些普通用户的操作视图（views），例如：登录，登出，修改密码以及重置密码

这个认证（authentication）框架位于django.contrib.auth，被其他Django的contrib包调用，我们在之前的blog引用中使用这个认证（authentication）框架并为blog创建了一个超级用户来管理站点。

我们在创建应用的时候，认证框架已经包含了，在settings.py中的MIDDLEWARE。

MIDDLEWARE = [

'django.middleware.security.SecurityMiddleware',

'django.contrib.sessions.middleware.SessionMiddleware',

'django.middleware.locale.LocaleMiddleware',

'django.middleware.common.CommonMiddleware',

'django.middleware.csrf.CsrfViewMiddleware',

'django.contrib.auth.middleware.AuthenticationMiddleware',

'django.contrib.messages.middleware.MessageMiddleware',

'django.middleware.clickjacking.XFrameOptionsMiddleware',

]

AuthenticationMiddleware:使用会话（sessions）将用户和请求（requests）进行关联

SessionMiddleware:通过请求（requests）操作当前会话（sessions）

这个认证（authentication）系统还包含了以下模型（models）：

User：一个包含了基础字段的用户模型（model）；这个模型（model）的主要字段有：username， password, email, first_name, last_name, is_active。

Group：一个组模型（model）用来分类用户

Permission：执行特定操作的标识

下面我们就要来创建一个登录的视图。通过执行以下的操作来登录用户

1 通过提交的表单获取username和password

2 将得到的用户名和密码和存储在数据库中的进行认证

3 检查用户是否存在

4 登录用户到网站并且开始一个认证和会话

首先创建一个登录表单，在form.py中添加如下代码：

class LoginForm(forms.Form):

username=forms.CharField()

password=forms.CharField(widget=forms.PasswordInput)

forms.PasswordInput是在密码输入的HTML界面进行渲染的。接着在views.py中添加登录处理的代码

def user_login(request):

if request.method == 'POST':

form=LoginForm(request.POST)

if form.is_valid():

cd=form.cleaned_data

user=authenticate(username=cd['username'],password=cd['password'])

if user is not None:

if user.is_active:

login(request,user)

return HttpResponse(u'登录成功')

else:

return HttpResponse(u'登录失败')

else:

return HttpResponse(u'非法登录，请注册用户')

else:

form=LoginForm()

return render(request,'blog/login.html',{'form':form})

1 通过使用form=LoginForm(request.POST)得到提交的实例化表单

2 form.is_valid()检查这个表单是否正确，如果正确，通过form.cleaned_data

取出登录的用户名和密码

3 如果用户是有效的，通过user=authenticate(username=cd['username'],password=cd['password'])

对获取到的用户名和密码进行认证

4 如果用户可用，则用login(request,user)方法集合用户到会话中然后返回一条成功的消息

接下来就是创建url了。在mysite的urls.py中添加url(r'^account/',include('blog.urls')),

urlpatterns = [

url(r'^admin/', admin.site.urls),

url(r'^blog/',include('blog.urls',namespace='blog',app_name='blog')),

url(r'^test/$',views.test),

url(r'^account/',include('blog.urls')),

]

在blog应用下的urls.py中添加url(r'^login/$',views.user_login)

urlpatterns = [

# post views

url(r'^$', views.post_list_page, name='post_list'),

url(r'^(?P<post_id>\d+)/share/$',views.post_share,name='post_share'),

url(r'^(?P<post_id>\d+)/comment/$',views.post_comment,name='post_comment'),

url(r'^test/$',views.test),

url(r'^login/$',views.user_login)

]

最后来看我们的登录模板，在templates/blog下新建一个login.html

{% extends "base.html" %}

{% block title %}登录{% endblock %}

{% block content %}

<h1>用户登录</h1>

<p>请输入用户名和密码:</p>

<form action="." method="post">

{{ form.as_p }}

{% csrf_token %}

<p><input type="submit" value="Log-in"></p>

</form>

{% endblock %}

现在视图，url，模板都已经具备了，下面我们就是要创建一个真实的用户了。运行服务器进入admin界面进行用户名注册：用超级用户名进入后在Users点击add

输入用户名和帐号

权限设置

这里注意一点，如果忘记了普通用户的用户名和密码，可以登录超级用户帐号进去修改，但是如果连超级用户的密码也忘记了，可以通过如下的方式来修改：

在pycharm中进入Python console

输入如下代码操作用户数据库：

from django.contrib.auth.models import User

user=User.objects.get(username='用户名')

user.set_password('密码‘)

user.save()

下面我们就来开始登录，在浏览器中输入：http://127.0.0.1:8000/account/login/

得到如下的界面

输入用户名和密码后提示登录成功。

django还提供以下视图（views）来处理认证（authentication）：

• login：操作表单（form）中的登录然后登录一个用户
• logout：登出一个用户
• logout_then_login：登出一个用户然后重定向这个用户到登录页面

Django提供以下视图（views）来操作密码修改：

• password_change:操作一个表单（form）来修改用户密码
• password_change_done:当用户成功修改他的密码后提供一个成功提示页面

Django还包含了以下视图（views）允许用户重置他们的密码：

• password_reset:允许用户重置他的密码。它会生成一条带有一个token的一次性使用链接然后发送到用户的邮箱中。
• password_reset_done:告知用户已经发送了一封可以用来重置密码的邮件到他的邮箱中。
• password_reset_complete:当用户重置完成他的密码后提供一个成功提示页面。

在blog应用中的urls.py中添加如下代码：

from django.contrib.auth.views import login

from django.contrib.auth.views import logout

from django.contrib.auth.views import logout_then_login

from django.contrib.auth.views import password_change

from django.contrib.auth.views import password_change_done

from django.contrib.auth.views import password_reset

from django.contrib.auth.views import password_reset_done

from django.contrib.auth.views import password_reset_confirm

from django.contrib.auth.views import password_reset_complete

然后在urlpatterns中添加对应的路径处理函数

urlpatterns = [

# post views

url(r'^$', views.post_list_page, name='post_list'),

url(r'^(?P<post_id>\d+)/share/$',views.post_share,name='post_share'),

url(r'^(?P<post_id>\d+)/comment/$',views.post_comment,name='post_comment'),

url(r'^test/$',views.test),

url(r'^login/$',login),

url(r'^logout/$', logout, name='logout'),

url(r'^logout-then-login/$', logout_then_login, name='logout_then_login'),

url(r'^password-change/$', password_change, name='password_change'),

url(r'^password-change/done/$', password_change_done, name='password_change_done'),

url(r'^password-reset/$',

password_reset,

name='password_reset'),

url(r'^password-reset/done/$',

password_reset_done,

name='password_reset_done'),

url(r'^password-reset/confirm/(?P<uidb64>[-\w]+)/(?P<token>[-\w]+)/$',

password_reset_confirm,

name='password_reset_confirm'),

url(r'^password-reset/complete/$',

password_reset_complete,

name='password_reset_complete'),

]

比如输入http://127.0.0.1:8000/account/password-change/则会自动跳转到密码修改的界面：

那么现在我们来优化下我们的登陆功能，前面在登陆完成以后跳转到一个页面提示跳转成功。现在我们来优化下这个功能，登陆后跳转到登陆前的界面

首先在url中

我们将url(r'^login/$',views.user_login)替换成url(r'^login/$',login,name="login")

也就是我们使用django中的登陆认证模块，使用这种认证模块必须在templates目录下创建一个新的目录命名为registration。这个路径是Django认证（authentication）视图（view）期望你的认证（authentication）模块（template）默认的存放路径。如果没有这个路径的话会提示如下的错误：

在这个新目录中创建一个新的文件，命名为login.html，然后添加如下代码：

{% extends "blog/base.html" %}

{% block title %}Log-in{% endblock %}

{% block content %}

<h1>用户登录</h1>

{% if form.errors %}

<p>

用户或密码不匹配，请输入正确的用户名和密码.

</p>

{% else %}

<p>填入下面的信息登陆:</p>

{% endif %}

<div class="login-form">

<form action="{% url 'login' %}" method="post">

{{ form.as_p }}

{% csrf_token %}

<input type="hidden" name="next" value="{{ next }}" />

<p><input type="submit" value="Log-in"></p>

</form>

</div>

{% endblock %}

我们添加了一个隐藏的HTML<input>元素来提交叫做next的变量值。当你在请求（request）中传递一个next参数（举个例子：http://127.0.0.1:8000/account/login/?next=/account/），这个变量是登录视图（view）首个设置的参数。

next参数必须是一个URL。当这个参数被给予的时候，Django登录视图（view）将会在用户登录完成后重定向到给予的URL。也就是在登陆完成后URL将从http://127.0.0.1:8000/account/login/?next=/account/跳转到http://127.0.0.1:8000/account

在settings.py中添加如下配置。LOGIN_URL和LOGOUT_URL中

from django.core.urlresolvers import reverse_lazy

LOGIN_URL = reverse_lazy('login')

LOGOUT_URL = reverse_lazy('logout')

这些设置的意义：

LOGIN_URL：重定向用户登录的URL（例如：使用login_required装饰器（decorator））。

LOGOUT_URL：重定向用户登出的URL。

我们使用reverse_lazy()来通过它们的名字动态构建URL。reverse_lazy()方法就像reverse()所做的一样reverses URLs，但是你可以通过使用这种方式在你项目的URL配置被读取之前进行reverse URLs。

我们现在来测试下，在post_list_page中使用login_required进行修饰

@login_required

def post_list_page(request):

object_list = Post.objects.all()

paginator = Paginator(object_list, 1)  # 3 posts in each page

page = request.GET.get('page')

new_comment = None

注意：这里的使用方式比较灵活。我们也可以在login_required中进行登录跳转界面的设置，这里设置了的话那么在settings.py中就不用设置了LOGIN_URL

@login_required(login_url='/account/login')

def post_list_page(request):

object_list = Post.objects.all()

paginator = Paginator(object_list, 1)  # 3 posts in each page

page = request.GET.get('page')

new_comment = None

下面我来进行测试，在浏览器中输入http://127.0.0.1:8000/blog。由于没有登录所以自动会跳转到http://127.0.0.1:8000/account/login/?next=/blog/进行用户登陆。这里并且传递了next的参数

输入用户名和密码后重新回到了http://127.0.0.1:8000/blog的地址并且显示了博客内容

既然已经实现了登陆，那么下面来看下退出登陆。首先在registration中创建一个logged_out.html。注意这个名称必须是logged_out，否则在退出登录的时候会自动跳转到admin/logout也就是管理页面的登出界面。文件代码如下：

{% extends "blog/base.html" %}

{% block title %}Logged out{% endblock %}

{% block content %}

<h1>用户退出</h1>

<p>你已经退出登陆<a href="{% url "login" %}">重新登陆</a></p>

{% endblock %}

在我们的博客显示界面添加退出登陆的链接：

<span class="user">

{% if request.user.is_authenticated %}

你好 {{ request.user.first_name }},

<a href="{% url "logout" %}">退出</a>

{% endif %}

</span>

页面显示如下

点击退出跳转到退出登陆的界面。我们点击重新登陆

我们点击重新登陆并再次输入用户名和密码却提示出错：

原因在于，我们在点重新登陆的时候，页面跳转到http://127.0.0.1:8000/account/login/。请注意，这个URL并没有next参数，也就是说只是纯粹的一个登录界面，在login.html中由于无法获取到next参数的值因此无法回到退出前的界面。此时url变为http://127.0.0.1:8000/accounts/profile/。我们在url中并没有这个路由，因此报错

那么如何解决呢，方法是在settings.py中设置登陆后的跳转界面

LOGIN_REDIRECT_URL = reverse_lazy('list')

并且在应用的urls.py中添加了路由

url(r'^$',views.post_list_page,name='list'),

这样在重新登陆后，界面将跳转到list这个url。这样我们再重新登录的时候就不会有问题了

在django的模块中还有修改密码，重置密码等功能，用法都是差不多的。这里简单介绍下

修改密码：

registration/目录下添加一个新的文件命名为password_form.html。添加如下代码：

{% extends "/blog/base.html" %}{% block title %}Change you password{% endblock %}{% block content %}

<h1>Change you password</h1>

<p>Use the form below to change your password.</p>

<form action="." method="post">

{{ form.as_p }}

<p><input type="submit" value="Change"></p>

{% csrf_token %}

</form>{% endblock %}

在相同的目录下创建另一个文件，命名为password_change_done.html来显示密码修改成功，为它添加如下代码：

{% extends "blog/base.html" %}{% block title %}Password changed{% endblock %}{% block content %}

<h1>Password changed</h1>

<p>Your password has been successfully changed.</p>

{% endblock %}