django项目教程-01

2019-08-04

创建django项目

首先进入到想要创建项目的文件目录下，在该目录下打开控制台（powershell、cmd都可以）或者使用pycharm打开该文件目录，进入下方 terminal 窗口，输入django-admin startproject mysite创建第一个django项目。

添加index页面，使用模板

在 django 项目中新建 templates 文件夹，并在其中添加 index.html ，

templates/index.html

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>{{ title }}</title>
</head>
<body>

    <p>主页</p>

</body>
</html>

在 mysite 应用中添加 views.py 写入代码，

mysite/views.py

from django.shortcuts import render
# 主页
def hello(request):
    content = {}
    content['title'] = "留言板"
    return render(request, 'index.html', content)

模板index中的{{ title }}会将我们在return render(request, 'index.html', content)中content的title值替换上去。这就是模板的作用。

修改 urls 的配置，和setting 的配置。

mysite/urls.py

from django.contrib import admin
from django.urls import path, include
from django.conf import settings

# 导入views
from . import views

urlpatterns = [
    path('admin/', admin.site.urls),
    path('', views.hello, name ='hello'), # 使用刚才写的hello作为表单
    ]

mysite/settings.py
由于使用了模板，我们需要吧模板目录添加进去，让django知道在哪里寻找它。

# 在 setting 中找到 TEMPLATES,在其中的'DIRS'添加 templates 文件夹的路径
TEMPLATES = [
    {
        ...
        'DIRS': [BASE_DIR+"/templates",], # 添加模板路径
        ...
]

然后runserver起来，便可以看到我们第一个页面了。

在进行下一步之前，我们来拓展一下我们的模板。

在templates 文件夹中添加 base.html 作为我们每一个页面的基底，

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>{{ title }}</title>
</head>
<body>

    {% block mainbody %}
    {% endblock %}

</body>
</html>

并修改index.html

{%extends "base.html" %}
{% block mainbody %}

<p>主页</p>

{% endblock %}

这是模板的第二个功能，内容嵌套，index 的内容，可以嵌套到 base 中，最后呈现出来的结果和第一次写的 index 是一模一样的。

添加django应用

接下来我们来制作一个具有用户系统的留言板项目。

（pycharm）在terminal窗口中进入django项目的根目录，输入命令django-admin startapp account 和 django-admin startapp messageBoard 创建2个应用。
如果不是pycharm，直接用 cmd 或者 powershell 都是可以的。

第一个account是用来作用户管理的，第二个messageBoard就是用来做留言信息管理的。创建完应用后进入settings.py中添加刚刚创建的两个应用。

mysite/settings.py

# 找到 INSTALLED_APPS, 在其后面添加 account 和 messageBoard

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'account',
    'messageBoard',
]

为account写用户模型

作为用户有2个属性，1是用户名，2是密码，其他可以按需添加。然后为它写几个方法。这里我添加了注册函数和验证密码是否正确的函数,添加完模型后要进入manage.py为添加的模型建立数据库。
这里同时给密码进行了加密处理，让存储在数据库的密码不为明文。

account/models.py

from django.db import models
from django.contrib.auth.hashers import make_password, check_password

# Create your models here.
class Users(models.Model):
    nickName = models.CharField('用户名', max_length = 30, primary_key = True)
    password = models.CharField('密码', max_length = 30)

    class Meta:
        db_table = 'Users'

    # 注册函数
    # 需要参数为：用户名， 密码
    # 当用户已存在返回 False
    # 注册成功返回 True
    @staticmethod
    def register(nName, psw):
        isRe = Users.objects.filter(nickName = nName)
        if not (isRe is None):
            Users.objects.create(
                nickName = nName,
                password = make_password(psw)
            )
            return True
        return False

    # 验证密码函数
    # 需要参数：用户名， 密码
    # 密码正确：True，否则为：False
    @staticmethod
    def checkPsw(nName, psw):
        hs_pw = Users.objects.filter(nickName = nName)[0].password
        return check_password(psw, hs_pw)

django对数据库进行操作很简单。如这里的Users类：

# 增加成员
Users.objects.create(
                nickName = nName,
                password = make_password(psw)
            )

# 寻找名字为 nName 的成员
Users.objects.filter(nickName = nName)

# 获取所有成员
Users.objects.all()

# 获取昵称中有A的成员
Users.objects.get(nickName = "A")

添加完模型后，在项目根目录进入命令窗口（terminal/cmd/powershell），输入 python manage.py makemigration 记录下我们对 models 的改动，然后输入python manage.py migrate 将改动写入到数据库。

为account添加视图和模板，写入urls测试

在account下的view添加注册的视图，当用户进入到该视图时先检查它是否进行了注册，然后获取注册信息，调用注册函数，并保存cookies然后返回结果。登录视图也相同，先检查是否进行了登入，调用验证密码的函数，返回结果。并写好对应的templates，在urls里加入就可以进行测试了。
首先为account添加注册,登入和登出的界面,

templates/register.html

{%extends "base.html" %}
{% block mainbody %}
<p>注册</p>
<form method="get" name="register">
    <label>用户名:</label><input type="text" name="NICKNAME">
    <label>密  码:</label><input type="password" name="PASSWORD">
    <label>确认密码:</label><input type="password" name="REPASSWORD">
    <input type="submit" value="注册">
</form>
{% endblock %}

然后是登入界面，和注册类似

{%extends "base.html" %}

{% block mainbody %}
<p>登入</p>
<form method="get" name="loginer">
    <label>用户名:</label><input type="text" name="NICKNAME">
    <label>密  码:</label><input type="password" name="PASSWORD">
    <input type="submit" value="登入">
</form>
{% endblock %}

最后是登出

{%extends "base.html" %}
{% block mainbody %}
<p>登出成功</p>
<a href="../">返回主页</a>
{% endblock %}

模板写好后就可以继续写我们的视图了。

account/views.py

from django.http import HttpResponseRedirect, HttpResponse
from django.shortcuts import render
from . import  models

# 注册
def register(request):
    content = {}
    content['title'] = "注册"
    # 检查是否输入了账号密码
    if ('NICKNAME' in request.GET) and ('PASSWORD' in request.GET):
        NICKNAME = request.GET['NICKNAME']
        PASSWORD = request.GET['PASSWORD']
        reg_result = models.Users.register(NICKNAME, PASSWORD)

        if reg_result == True:
            # 注册完成保存cookies
            response = HttpResponseRedirect('/')
            response.set_cookie('USER', NICKNAME, expires=60 * 60 * 24 * 7)
            return response
        else:
            content_err = {
                'title': '错误',
                'errorMessage': '用户已存在',
            }
            return render(request, 'error.html', content_err)

    return render(request, 'register.html', content)

# 登入
def usrlogin(request):
    content = {}
    content['title'] = '登入'
    # 检查是否输入了账号密码
    if ('NICKNAME' in request.GET) and ('PASSWORD' in request.GET):
        NICKNAME = request.GET['NICKNAME']
        PASSWORD = request.GET['PASSWORD']
        IsPass = models.Users.checkPsw(NICKNAME, PASSWORD)
        if IsPass:
            # 登录完成保存cookies
            response = HttpResponseRedirect('/')
            response.set_cookie('USER', NICKNAME, expires=60 * 60 * 24 * 7)
            return response
        else:
            content_err = {
                'title': '错误',
                'errorMessage': '密码错误',
            }
            return render(request, 'error.html', content_err)
    return render(request, 'login.html', content)

# 登出
def logout(request):
    content = {}
    content['title'] = "登出"
    response = render(request, 'logout.html', content)
    response.delete_cookie('USER')
    return response

这里我使用了 cookies 来保存用户名字来识别用户登入状态。cookies 只要不主动删除，浏览器会一直为其保留直到有效期过。在这段期间内 cookies 都可以被读取到。

然后，在 account 文件夹中添加 urls.py 专门管理这个应用的路由

account/urls.py

from django.urls import path

from . import views
app_name = 'account'
urlpatterns = [
    path('register', views.register, name = 'register'),
    path('login', views.usrlogin, name = 'login'),
    path('logout', views.logout, name = 'logout'),
]

最后在 mysite/urls.py 中导入 account 的 urls 就可以了

mysite/urls.py

urlpatterns = [
    path('admin/', admin.site.urls),
    path('', views.hello, name ='hello'),
    path('account/', include('account.urls', namespace='account')),
]

然后方便测试，在 base.html 中添加用户操作的链接。

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>{{ title }}</title>
</head>
<body>
	<a href="{% url 'hello' %}">主页</a>
    {% if 'USER' in request.COOKIES %}
    <a href="{% url 'account:logout' %}">登出</a>
    {% else %}
	<a href="{% url 'account:login' %}">登入</a></li>
	<a href="{% url 'account:register' %}">注册</a></li>
	{% endif %}
    {% block mainbody %}
    {% endblock %}
</body>
</html>

这里新用到了模板的2个功能，一个是 url,

1	{% url '路径名' %}

相当于直接访问 url 中 name 为 “路径名” 的地址。

1
2
3

{% if 条件 %}  
{% else %}  
{% endif %}

就是段 if 判断和 python 的 if 功能是一样的
然后就可以 runserver 开始测试了。