Django 系列博客(二)
django 系列博客(二)
前言
今天博客的内容为使用 django 完成第一个 django 页面,并进行一些简单页面的搭建和转跳。
命令行搭建 django 项目
创建纯净虚拟环境
在上一篇博客中已经安装好了虚拟环境,所以用虚拟环境来安装指定版本的 django。为了可以从头到尾的走一遍流程,我重新创建了一个虚拟环境。
激活虚拟环境并安装 django
- 首先进入虚拟环境路径下的 bin 目录
- 使用命令激活虚拟环境
- 安装指定版本 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&swqb@xlwgel7n$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)