Django 系列博客

Posted 2021-02-01 zuanzuan

Django 系列博客（二）

前言

今天博客的内容为使用 Django 完成第一个 Django 页面，并进行一些简单页面的搭建和转跳。

命令行搭建 Django 项目

创建纯净虚拟环境

在上一篇博客中已经安装好了虚拟环境，所以用虚拟环境来安装指定版本的 Django。为了可以从头到尾的走一遍流程，我重新创建了一个虚拟环境。

激活虚拟环境并安装 Django

1. 首先进入虚拟环境路径下的 bin 目录
2. 使用命令激活虚拟环境

1. 安装指定版本 Django

首先使用 pip3 list 命令查看

可以看到都是创建虚拟环境时安装的依赖包，现在使用 pip 命令安装指定 django 版本，因为做项目需要稳定，所以安装的版本不是最新的。

可以看到新安装了2个包，pytz 是 python time zone 的缩写，是用来转换时区的包。

创建项目

前往目标路径创建项目，在这里我的 django 项目都在我的家目录下面的 django_project里面。

进入要创建项目的路径下，使用下面的命令创建一个 django 项目。

django-admin startproject project_name

可以看到多了个文件夹。查看项目结构

创建应用

进入项目根目录使用下面命令创建一个 app。

python3 manage.py startapp app_name

创建成功并查看项目结构。

启动项目

使用下面命令

python3 manage.py runserver 127.0.0.1:8888

成功后会在本机上的8888端口开启 django 服务

访问8888端口会显示下图页面

好了，到现在你已经开启了第一个 django 服务，并且还是使用了命令行。

pycharm 创建 Django 项目

其实会使用命令行创建项目那么使用 pycharm 应该是手到擒来，毕竟 pycharm 已经做了很多工作了。不过也有点麻烦。。。

在虚拟环境下使用 pycharm 安装指定django 版本

创建项目

项目目录结构及作用

项目目录：包含项目最基本的一些配置
    -- __init__.py：模块的配置文件，将blog_proj文件夹变成了模块
    -- settings.py：配置总文件
    -- urls.py：url配置文件，django项目中的所有页面都需要对其配置url地址
    -- wsgi.py：(web server gateway interface)，服务器网关接口，python应用与web服务器直接通信的接口
templates：模板文件夹，存放html文件的(页面)，支持使用Django模板语言(DTL)，也可以使用第三方(jinja2)
manage.py：项目管理器，与项目交互的命令行工具集的入口，查看支持的所有命令python3 manage.py

settings.py结构

import os
# 项目根目录
BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))

# 项目安全码
SECRET_KEY = ‘guwba1u$18=&*8kf44_u&[email protected]$0rs=(+f10yvz)p0‘

# 调试模式，上线项目要关闭debug模式，不然后台出现异常会直接抛给前台展现给用户看了
DEBUG = True

# 在上线项目中，规定只能以什么ip地址来访问django项目
# DEBUG = FALSE
# ALLOWED_HOSTS = [‘localhost‘]
ALLOWED_HOSTS = []

# 项目自带的应用
# 我们创建了自己的应用就要将自定义应用添加到该配置
INSTALLED_APPS = [
    ‘django.contrib.admin‘,
    ‘django.contrib.auth‘,
    ‘django.contrib.contenttypes‘,
    ‘django.contrib.sessions‘,
    ‘django.contrib.messages‘,
    ‘django.contrib.staticfiles‘,
]

# 中间件
# django自带的工具集
MIDDLEWARE = [
    ‘django.middleware.security.SecurityMiddleware‘,
    ‘django.contrib.sessions.middleware.SessionMiddleware‘,
    ‘django.middleware.common.CommonMiddleware‘,
    ‘django.middleware.csrf.CsrfViewMiddleware‘,
    ‘django.contrib.auth.middleware.AuthenticationMiddleware‘,
    ‘django.contrib.messages.middleware.MessageMiddleware‘,
    ‘django.middleware.clickjacking.XFrameOptionsMiddleware‘,
]

# 配置url配件文件的根文件，执行urls.py
ROOT_URLCONF = ‘项目目录.urls‘

# 模板，一个个html文件
TEMPLATES = [
    {
        # 如果使用第三方，可以在这个地方修改模板引擎
        ‘BACKEND‘: ‘django.template.backends.django.DjangoTemplates‘,
        ‘DIRS‘: [os.path.join(BASE_DIR, ‘templates‘)]
        ,
        ‘APP_DIRS‘: True,
        ‘OPTIONS‘: {
            ‘context_processors‘: [
                ‘django.template.context_processors.debug‘,
                ‘django.template.context_processors.request‘,
                ‘django.contrib.auth.context_processors.auth‘,
                ‘django.contrib.messages.context_processors.messages‘,
            ],
        },
    },
]

# 服务器网关接口应用
WSGI_APPLICATION = ‘项目目录.wsgi.application‘

# 数据库配置
# 要配置自定义数据库去下面链接去查询详细配置
# https://docs.djangoproject.com/en/1.11/ref/settings/#databases
DATABASES = {
    ‘default‘: {
        ‘ENGINE‘: ‘django.db.backends.sqlite3‘,
        ‘NAME‘: os.path.join(BASE_DIR, ‘db.sqlite3‘),
    }
}

# 密码认证配置
# https://docs.djangoproject.com/en/1.11/ref/settings/#auth-password-validators
AUTH_PASSWORD_VALIDATORS = [
    {
        ‘NAME‘: ‘django.contrib.auth.password_validation.UserAttributeSimilarityValidator‘,
    },
    {
        ‘NAME‘: ‘django.contrib.auth.password_validation.MinimumLengthValidator‘,
    },
    {
        ‘NAME‘: ‘django.contrib.auth.password_validation.CommonPasswordValidator‘,
    },
    {
        ‘NAME‘: ‘django.contrib.auth.password_validation.NumericPasswordValidator‘,
    },
]


# 国际化相关配置
# https://docs.djangoproject.com/en/1.11/topics/i18n/
LANGUAGE_CODE = ‘en-us‘
TIME_ZONE = ‘UTC‘
USE_I18N = True
USE_L10N = True
USE_TZ = True

# 静态文件地址 (CSS, javascript, Images)
# https://docs.djangoproject.com/en/1.11/howto/static-files/
STATIC_URL = ‘/static/‘

创建项目应用

使用 pycharm 自带的命令行工具来创建应用

应用创建完后将应用名添加到 settings.py文件中

INSTALLED_APPS = [
    ‘django.contrib.admin‘,
        ...
    ‘django.contrib.staticfiles‘,
    # 添加的自定义应用
    ‘app‘,
]

app目录结构

创建后的 app 目录结构和使用命令行创建的一样，下面来看看具体都有什么作用

migrations：数据迁移(移植)模块，内容都是由Django自动生成
    -- __init__.py
__init__.py
admin.py：应用的后台管理系统配置
apps.py：django 1.9后，本应用的相关配置
models.py：数据模型模块，使用ORM框架，类似于MVC模式下的Model层
tests.py：自动化测试模块，可以写自动化测试脚本
views.py：执行相应的逻辑代码模块(相应什么，如何相应)，代码逻辑处理的主要地点，项目的大部分代码所在位置

页面响应

第一个响应

通过配置路由和视图文件来响应第一次连接请求。

配置路由

from django.conf.urls import url
from django.contrib import admin

# 导入应用视图
import app.views as app_view # 取别名

# 配置路由
urlpatterns = [
    url(r‘^admin/‘, admin.site.urls),
    # 为指定函数配置 url
    url(r‘^index/&‘, app_view.index)
]

配置视图

# 导入处理请求的 http 相应功能
from django.http import HttpResponse

# django中每一个请求都会设置相应函数来进行处理
# 函数的参数约定为 request
def index(request):
    return HttpResponse(‘index page!‘)

启动服务

启动服务后访问 localhost:8000/index/，可以看到响应为 index 函数里填写的响应，说明服务成功启动并且响应了自己想要的响应字符串。

第一个模板页面

项目目录下有个 templates 文件夹是专门用于存放页面资源的，比如index.html

from django.shortcuts import render

def index(request):
    # 参数：请求对象 request，模板 html 文件，传给前台的资源
    return render(request, ‘index.html‘)

index.html 文件

 <!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>主页</title>
</head>
<body>
    <h1>这是主页</h1>
</body>
</html>

配置完成后，访问127.0.0.1:8000/index/后显示为：

在 views.py文件中编写对应响应功能函数时，会自动出现模板文件

这是因为在 settings.py文件中已经把模板路径配置好了

TEMPLATES = [
    {
        # 如果使用第三方，可以在这个地方修改模板引擎
        ‘BACKEND‘: ‘django.template.backends.django.DjangoTemplates‘,
        # 模板页面默认路径：项目根路径下的templates文件夹
        ‘DIRS‘: [os.path.join(BASE_DIR, ‘templates‘)]
        ,
        # 允许所有app均拥有自己的模板文件夹
        ‘APP_DIRS‘: True,
        ...
    },
]

第一个重定向

和上面的一样，首先在 views.py文件中配置响应函数

from django.shortcuts import render, redirect
# / 路径渲染index.html页面
def home(request):
    return render(request, ‘index.html‘)
# /index/ 路径重定向到 / 路径，达到渲染index.html页面
def index(request):
    return redirect(‘/‘)

响应的路由配置为

from django.conf.urls import url
from django.contrib import admin
# 导入应用视图
import app.views as app_view
urlpatterns = [
    url(r‘^admin/‘, admin.site.urls),
    url(r‘^index/$‘, app_view.index),
    url(r‘^$‘, app_view.home),
]

状态码显示为301说明发生了转跳，查看网络详细信息发现在index/中有个 location 字段，

该字段值为 /，说明转跳到了根目录下。

其他配置

url应用移植

项目目录下的urls.py文件

# 导入include功能，将url配置转移到指定应用内部的自身url配置文件
from django.conf.urls import url, include
from django.contrib import admin
urlpatterns = [
    url(r‘^admin/‘, admin.site.urls),
    # 将url配置操作交给app_test自身的urls.py来进行操作
    # app-test/为app_test应用的总路径
    url(r‘^app-test/‘, include(‘app_test.urls‘)),
]

app_test下的urls.py文件

from django.conf.urls import url
from . import views
urlpatterns = [
    # 1.不要直接留空，直接留空 http://localhost:8000/app-test/* 均可以访问
    # 2.如果要配置index，访问的地址为 http://localhost:8000/app-test/index
    # 3.配置方式：r‘^index/$‘，不要省略 / 符号
    # 4.正则是否以$标识结尾取决于该路径是否会有下一级路径
    url(r‘^$‘, views.index),
]

多应用相同模板页面冲突

如果在两个应用中均有相同的模板页面假如为index.html

# 1.在应用templates文件夹下建立与应用同名的文件夹，eg：app_text下就建立app_text
# 2.将模板创建在与应用同名的模板文件夹下
# 3.修改指定应用下views.py处理请求的render模板指向
def index(request):
    # 模板指向：blog_app应用的templates下的blog_app文件夹中的index.html
    return render(request, ‘app_text/index.html‘)

静态资源的配置

假如页面需要一些静态资源，比如需要 css 样式、js 文件等，那么就需要在 settings 文件中配置好静态文件的路径。

配置 settings.py文件

# 静态文件地址 (CSS, JavaScript, Images)
# https://docs.djangoproject.com/en/1.11/howto/static-files/
STATIC_URL = ‘/static/‘
# 在项目根目录下新建static文件夹，静态资源均放在该文件夹中
# 增加STATICFILES_DIRS配置
STATICFILES_DIRS = [
    os.path.join(BASE_DIR, ‘static‘)
]
# 前端页面加载静态资源的路径：/static/... (...为具体在static文件夹中的路径)

拓展静态资源配置

# 如果要将项目根目录下source文件夹也作为静态资源路径
# STATICFILES_DIRS增加source配置
STATICFILES_DIRS = [
    os.path.join(BASE_DIR, ‘static‘),
    os.path.join(BASE_DIR, ‘source‘)
]
# 前端页面加载静态资源路径依旧不变，Django会自动索引：/static/... (...为具体在source文件夹中的路径)

url正则

原生字符串

# urls.py配置路由
url(r‘test‘, app_view.test)

# views.py设置响应函数
def test(request):
    return HttpResponse(‘test‘)

# 问题：请求地址包含test均可以访问
# http://127.0.0.1:8000/test => /test | /atest | /testa | /atesta | /test/a | /test/

开头

# urls.py配置路由
url(r‘^test‘, app_view.test)

# views.py设置响应函数
def test(request):
    return HttpResponse(‘test‘)

# 问题：请求地址以test开头均可以访问
# http://127.0.0.1:8000/test => /test | /testa | /test/a | /test/

结尾

# urls.py配置路由
url(r‘^test$‘, app_view.test)

# views.py设置响应函数
def test(request):
    return HttpResponse(‘test‘)

# 问题：只能一种方式访问
# http://127.0.0.1:8000/test => /test
# 不能以 /test/ 访问
# http://127.0.0.1:8000/test/

优化结尾

# urls.py配置路由
url(r‘^test/$‘, app_view.test)

# views.py设置响应函数
def test(request):
    return HttpResponse(‘test‘)

# /test 和 /test/ 均可以访问
# http://127.0.0.1:8000/test
# http://127.0.0.1:8000/test/

# 问题：不能作为应用总路由
# eg：app_test应用在项目urls.py
# url(r‘^app-test/‘, include(‘app_test.urls‘)) 末尾不能加$，因为作为应用总目录，是有下一级，如果用$标识结尾了，就代表不能有下一级路由

地址捕获

# urls.py配置路由
url(r‘^test/(d+)/d+/(d+)/$‘, app_view.test)

# 对应请求路径
# http://127.0.0.1:8000/test/1/22/333/

# 对应响应函数
def test(request, arg1, arg2):
    # arg1: str 1
    # arg2: str 333
    return HttpResponse(‘test‘)

小结

# 常规路由配置
# r‘^index/$‘
# r‘^page/2/$‘

# 应用路由配置
# r‘^app/‘

# 根路由配置
# r‘^$‘

# 路由配置均以 / 结尾
# ()中的字段会被请求响应函数捕获

# 限制响应函数捕获的变量名
# (?P<num>[0-9]+) 响应函数参数(requset, num)