前言
发了不少关于Django的文章,但关于大多都是小部分,不完全,大概整理一下笔记,之后会争取把Django一套体系写完。今天发表第一天的Django学习笔记。
文章目录
Django框架的介绍
-
2005年发布,采用Python语言编写的开源web框架
-
早期的时候Django主做新闻和内容管理的
-
一个重量级的 Python Web框架,Django 配备了常用的大部分组件
- 基本配置
- 路由系统
- 原生HTML模板系统
- 视图 view
- Model模型,数据库连接和ORM数据库管理
- 中间件
- Cookie & Seesion
- 分页
- 数据库后台管理系统admin
-
Django的用途[后端开发,服务器开发]
- 网站后端开发
- 微信公众号、微信小程序等后台开发
- 基于HTTP/HTTPS协议的后台服务器开发
- tornado/gevent 4层
- 在线语音/图像识别服务器
- 在线第三方身份验证服务器等
-
Django的版本
- 最新版本:2.2.x
- 当前教学版本:1.11.8
-
Django的官网
- 官方网址: http://www.djangoproject.com
- 中文文档(第三方):
- Django的离线文档
- 解压缩数据包
django-docs-1.11-en.zip
- 用浏览器打开
django-docs-1.11-en/index.html
- 解压缩数据包
Django的安装
-
查看已安装的版本
>>> import django >>> print(django.VERSION) (1, 11, 8, 'final', 0)
-
安装
- 在线安装
$ sudo pip3 install django
安装django的最新版本- 或
$ sudo pip3 install django[==版本]
安装django的指定版本- 如:
$ sudo pip3 install django==1.11.8
- 离线安装
- 下载安装包:
- 安装离线包
$ tar -xvf Django-1.11.8.tar.gz
$ cd Django-1.11.8
$ sudo python3 setup.py install
- 用wheel离线安装
- 下载安装包:
pip3 download -d /home/tarena/django_packs django==1.11.8
- 安装离线包
- $ pip3 install Django-1.11.8.whl
- 下载安装包:
- 在线安装
-
Django的卸载
-
$ pip3 uninstall django
-
Django 的开发环境
- Django 1.11.x 支持 Python 2.7, 3.4, 3.5 和 3.6(长期支持版本 LTS)
- 注: Django 1.11.x 不支持 Python 3.7
Django框架开发
创建项目的指令
-
$ django-admin startproject 项目名称 --> 项目文件夹
-
如:
- $ django-admin startproject mysite1
-
运行
$ cd mysite1 $ python3 manage.py runserver # 或 $ python3 manage.py runserver 5000 # 指定只能本机使用127.0.0.1的5000端口访问本机
Django项目的目录结构
-
示例:
$ django-admin startproject mysite1 $ tree mysite1/ mysite1/ ├── manage.py └── mysite1 ├── __init__.py ├── settings.py ├── urls.py └── wsgi.py 1 directory, 5 files
补充解释:
mysite1里面在运行之后多了一个_pycache_文件__pycache__ 是 Python 解释器自动创建的一个目录,用于存储编译后的 Python 文件,即字节码文件。当您运行一个 Python 程序时,Python 解释器会将 .py 文件(源代码)编译成 .pyc 文件(字节码),这些编译后的文件就存放在 __pycache__ 目录中。 字节码是平台无关的,但为了提高性能,Python 解释器通常会在 __pycache__ 目录中缓存编译后的字节码,以便在下次运行同一程序时跳过编译步骤。边编译边执行的。
-
项目目录结构解析:
- manage.py
- 此文件是项目管理的主程序,在开发阶段用于管理整个项目的开发运行的调式
manage.py
包含项目管理的子命令, 如:python3 manage.py runserver
启动服务python3 manage.py startapp
创建应用python3 manage.py migrate
数据库迁移...
- mysite1 项目包文件夹
- 项目包的主文件夹(默认与项目名称一致)
-
__init__.py
- 包初始化文件,当此项目包被导入(import)时此文件会自动运行
-
wsgi.py
- WSGI 即 Web Server Gateway Interface 与 nginx 相连
- WEB服务网关接口的配置文件,仅部署项目时使用
-
urls.py
- 项目的基础路由配置文件,所有的动态路径必须先走该文件进行匹配
-
settings.py
- Django项目的配置文件, 此配置文件中的一些全局变量将为Django框架的运行传递一些参数
- setting.py 配置文件,启动服务时自动调用,
- 此配置文件中也可以定义一些自定义的变量用于作用全局作用域的数据传递
http://127.0.0.1:8000/admin/
- manage.py
-
settings.py
文件介绍-
BASE_DIR
- 用于绑定当前项目的绝对路径(动态计算出来的), 所有文件都可以依懒此路径
-
DEBUG
- 用于配置Django项目的启用模式, 取值:
- True 表示开发环境中使用
调试模式
(用于开发中) - False 表示当前项目运行在
生产环境中
(不启用调试)
- True 表示开发环境中使用
- 用于配置Django项目的启用模式, 取值:
-
ALLOWED_HOSTS
- 设置允许访问到本项目的网络地址列表,取值:
- [] 空列表,表示只有
127.0.0.1
,localhost
能访问本项目 - [‘*’],表示任何网络地址都能访问到当前项目
- [‘192.168.1.3’, ‘192.168.3.3’] 表示只有当前两个主机能访问当前项目
- 注意:
- 如果要在局域网其它主机也能访问此主机,启动方式应使用如下模式:
- [] 空列表,表示只有
python3 manage.py runserver 0.0.0.0:5000
# 指定网络设备所有主机都可以通过5000端口访问(需加ALLOWED_HOSTS = ['*']
)
- 设置允许访问到本项目的网络地址列表,取值:
-
INSTALLED_APPS
- 指定当前项目中安装的应用列表
-
MIDDLEWARE
- 用于注册中间件
-
TEMPLATES
- 用于指定模板的配置信息
-
DATABASES
- 用于指定数据库的配置信息
-
LANGUAGE_CODE
- 用于指定语言配置
- 取值:
- 英文 :
"en-us"
- 中文 :
"zh-Hans"
- 英文 :
-
TIME_ZONE
- 用于指定当前服务器端时区
- 取值:
- 世界标准时间:
"UTC"
- 中国时区 :
"Asia/Shanghai"
- 世界标准时间:
-
ROOT_URLCONF
- 用于配置根级 url 配置 ‘mysite1.urls’
- 如:
ROOT_URLCONF = 'mysite1.urls'
注: 此模块可以通过
from django.conf import settings
导入和使用 -
URL 介绍
-
url 即统一资源定位符 Uniform Resource Locator
-
作用:
- 用来表示互联网上某个资源的地址。
-
说明:
- 互联网上的每个文件都有一个唯一的URL,它包含的信息指出文件的位置以及浏览器应该怎么处理它。
-
URL的一般语法格式为:
-
https://www.djangoproject.com/download/
protocol :// hostname[:port] / path [?query][#fragment]
-
如:
http://tts.tmooc.cn/video/showVideo?meuId=657421&version=AID201908#s
-
说明:
- protocol(协议)
- http 通过 HTTP 访问该资源。 格式
HTTP://
- https 通过安全的 HTTPS 访问该资源。 格式
HTTPS://
- file 资源是本地计算机上的文件。格式:
file:///
- …
- http 通过 HTTP 访问该资源。 格式
- hostname(主机名)
- 是指存放资源的服务器的域名系统(DNS) 主机名、域名 或 IP 地址。
- port(端口号)
- 整数,可选,省略时使用方案的默认端口;
- 各种传输协议都有默认的端口号,如http的默认端口为80。 HTTPS 443
- path(路由地址)
- 由零或多个“/”符号隔开的字符串,一般用来表示主机上的一个目录或文件地址。路由地址决定了服务器端如何处理这个请求
- query(查询)
- 可选,用于给动态网页传递参数,可有多个参数,用“&”符号隔开,每个参数的名和值用“=”符号隔开。
- fragment(信息片断)
- 字符串,用于指定网络资源中的片断。例如一个网页中有多个名词解释,可使用fragment直接定位到某一名词解释。
- 注: [] 代表其中的内容可省略
- protocol(协议)
视图函数(view)
-
视图函数是用于接收一个浏览器请求并通过HttpResponse对象返回数据的函数。此函数可以接收浏览器请求并根据业务逻辑返回相应的内容给浏览器
-
视图处理的函数的语法格式:
def xxx_view(request[, 其它参数...]): #获取浏览器参数和数据 return HttpResponse对象 #返回给浏览器对象
-
参数:
- request用于绑定HttpRequest对象,通过此对象可以获取浏览器的参数和数据
-
示例:
- 视图处理函数
views.py
# file : <项目名>/views.py from django.http import HttpResponse def page1_view(request): html = "<h1>这是第1个页面</h1>" return HttpResponse(html)
- 视图处理函数
Django 中的路由配置
- settings.py 中的
ROOT_URLCONF
指定了主路由配置列表urlpatterns的文件位置 - urls.py 主路由配置文件
# file : <项目名>/urls.py urlpatterns = [ url(r'^admin/', admin.site.urls), ... # 此处配置主路由 ]
urlpatterns 是一个路由-视图函数映射关的列表,此列表的映射关系由url函数来确定
-
url() 函数
- 用于描述路由与视图函数的对应关系
- 模块
from django.conf.urls import url
- 语法:
- url(regex, views, name=None)
- 参数:
- regex: 字符串类型,匹配的请求路径,允许是正则表达式
- views: 指定路径所对应的视图处理函数的名称
- name: 为地址起别名,在模板中地址反向解析时使用
每个正则表达式前面的r表示
'\'
不转义的原始字符串
-
练习
- 建立一个小网站:
- 输入网址: http://127.0.0.1:8000, 在网页中输出 : 这是我的首页
- 输入网址: http://127.0.0.1:8000/page1, 在网页中输出 : 这是编号为1的网页
- 输入网址: http://127.0.0.1:8000/page2, 在网页中输出 : 这是编号为2的网页
提示: 主页路由的正则是
r'^$'
,较新版本:Django3.2.12 ,使用 ‘内容’ 配置路由- 思考
- /page3 /page4 … /page100
- 建立如上一百个网页该怎么办?
-知识补充:
当项目运行时,ctrl+z和ctrl+c有什么区别
ctrl+c:退出项目
ctrl+z:停止项目,但是进程还是占在,后台还是运行的,当再次运行该项目时,会显示进程已经使用 - 建立一个小网站:
带有分组的路由和视图函数
-
在视图函数内,可以用正则表达式分组
()
提取参数后用函数位置传参传递给视图函数 -
理解:
1.在urls里面正则匹配参数(在浏览器中输入的参数),浏览器与views相互传数据
2.浏览器把数据给viws的一个函数,views设置一个参数来接收这个数据
版本 1.1:使用正则匹配 版本:3.2.12:path(‘pagint:num’,views.pagn_view) 这个专门匹配数字这里 <int:num> 是一个路径转换器,它会匹配一个或多个数字,并将其作为参数 num 传递给视图函数 pagn_view。
-
一个分组表示一个参数,多个参数需要使用多个分组,并且使用/隔开
-
- http://127.0.0.1:8000/year/2018
- http://127.0.0.1:8000/year/2019
- http://127.0.0.1:8000/year/??? # 四位数字
-
-
练习:
-
定义一个路由的格式为:
- http://127.0.0.1:8000/整数/操作字符串/整数
-
从路由中提取数据,做相应的操作后返回给浏览器
-
如:
输入: 127.0.0.1:8000/100/add/200 页面显示 结果:300 输入: 127.0.0.1:8000/100/sub/200 页面显示 结果:-100 输入: 127.0.0.1:8000/100/mul/200 页面显示 结果:20000
-
-
注意:
- urls的路由匹配所定义的值必须要和views里的一模一样,否则会报错
path('pag<int:num1>/<str:style1>/<int:num2>/', views.pagns_view def pagns_view(request, num1, style1, num2)
带有命名分组的路由和视图函数
-
在url 的正则表达式中可以使用命名分组(捕获分组)
-
说明:
- 在视图函数内,可以用正则表达式分组
(?P<name>pattern)
提取参数后用函数关键字传参传递给视图函数
- 在视图函数内,可以用正则表达式分组
-
示例:
- 路由配置文件
# file : <项目名>/urls.py # 以下示例匹配 # http://127.0.0.1:8000/person/weimingze/35 # http://127.0.0.1:8000/person/shibowen/29 # http://127.0.0.1:8000/person/xiaowei/9 urlpatterns = [ url(r'^admin/', admin.site.urls), url(r'^person/(?P<name>\w+)/(?P<age>\d{1,2})',views.person_view), ]
- 路由配置文件
-
练习:
- 访问地址:
- http://127.0.0.1:8000/birthday/四位数字/一到两位数字/一到两位数字
- http://127.0.0.1:8000/birthday/一到两位数字/一到两位数字/四位数字
- 最终输出: 生日为: xxxx年xx月xx日
- 如:
输入网址: http://127.0.0.1:8000/birthday/2015/12/11
显示为: 生日为:2015年12月11日
输入网址: http://127.0.0.1:8000/birthday/2/28/2008
显示为: 生日为:2008年2月28日
# 解决方法[3] 1.匹配层面[做出规定] 2.返回给浏览器层面 3.也可以直接写两个匹配的urls
- 访问地址:
-
PyCharm 社区版针对Django项目调试方法
- 添加自己调式配置
- 选择 Add Configuration…
- 点击
+
号添加一个自己的配置- 选择运行的项目的主模块位置 manage.py
- 添加 runserver 命令行参数
- 添加自己调式配置
HTTP协议的请求和响应
- 请求是指浏览器端通过HTTP协议发送给服务器端的数据
- 响应是指服务器端接收到请求后做相应的处理后再回复给浏览器端的数据
HTTP 请求
-
根据HTTP标准,HTTP请求可以使用多种请求方法。
-
HTTP1.0定义了三种请求方法: GET, POST 和 HEAD方法(最常用)
-
HTTP1.1新增了五种请求方法:OPTIONS, PUT, DELETE, TRACE 和 CONNECT 方法。
-
HTTP1.1 请求详述
序号 方法 描述 1 GET 请求指定的页面信息,并返回实体主体。 2 HEAD 类似于get请求,只不过返回的响应中没有具体的内容,用于获取报头 3 POST 向指定资源提交数据进行处理请求(例如提交表单或者上传文件)。数据被包含在请求体中。POST请求可能会导致新的资源的建立和/或已有资源的修改。 4 PUT 从客户端向服务器传送的数据取代指定的文档的内容。 5 DELETE 请求服务器删除指定的页面。 6 CONNECT HTTP/1.1协议中预留给能够将连接改为管道方式的代理服务器。 7 OPTIONS 允许客户端查看服务器的性能。 8 TRACE 回显服务器收到的请求,主要用于测试或诊断。 -
HttpRequest对象
- 视图函数的第一个参数是HttpRequest对象
- 服务器接收到http协议的请求后,会根据请求数据报文创建HttpRequest对象
- HttpRequest属性
- path:字符串,表示请求的路由信息
- path_info: URL字符串
- method:字符串,表示HTTP请求方法,常用值:‘GET’、‘POST’
- encoding:字符串,表示提交的数据的编码方式
- 如果为None则表示使用浏览器的默认设置,一般为’utf-8’
- 这个属性是可写的,可以通过修改它来修改访问表单数据使用的编码,接下来对属性的任何访问将使用新的encoding值
- GET:QueryDict查询字典的对象,包含get请求方式的所有数据
- POST:QueryDict查询字典的对象,包含post请求方式的所有数据
- FILES:类似于字典的对象,包含所有的上传文件信息
- COOKIES:Python字典,包含所有的cookie,键和值都为字符串
- session:似于字典的对象,表示当前的会话,
- body: 字符串,请求体的内容(POST或PUT)
- environ: 字符串,客户端运行的环境变量信息
- scheme : 请求协议(‘http’/‘https’)
- request.get_full_path() : 请求的完整路径
- request.get_host() : 请求的主机
- request.META : 请求中的元数据(消息头)
- request.META[‘REMOTE_ADDR’] : 客户端IP地址
HTTP 响应
-
当浏览者访问一个网页时,浏览者的浏览器会向网页所在服务器发出请求。当浏览器接收并显示网页前,此网页所在的服务器会返回一个包含HTTP状态码的信息头用以响应浏览器的请求。(默认是get)
-
HTTP状态码的英文为HTTP Status Code。
-
下面是常见的HTTP状态码:
- 200 - 请求成功
- 301 - 资源(网页等)被永久转移到其它URL
- 404 - 请求的资源(网页等)不存在
- 500 - 内部服务器错误
-
HTTP状态码分类
-
HTTP状态码由三个十进制数字组成,第一个十进制数字定义了状态码的类型,后两个数字没有分类的作用。HTTP状态码共分为5种类型:
分类 分类描述 1** 信息,服务器收到请求,需要请求者继续执行操作 2** 成功,操作被成功接收并处理 3** 重定向,需要进一步的操作以完成请求 4** 客户端错误,请求包含语法错误或无法完成请求 5** 服务器错误,服务器在处理请求的过程中发生了错误
-
-
Django中的响应对象HttpResponse:
-
构造函数格式:
HttpResponse(content=响应体, content_type=响应体数据类型, status=状态码)
-
作用:
- 向客户端浏览器返回响应,同时携带响应体内容
-
参数:
- content:表示返回的内容。
- status_code:返回的HTTP响应状态码(默认为200)。
- content_type:指定返回数据的的MIME类型(默认为"text/html")。浏览器会根据这个属性,来显示数据。如果是text/html,那么就会解析这个字符串,如果text/plain,那么就会显示一个纯文本。
- 常用的Content-Type如下:
'text/html'
(默认的,html文件)'text/plain'
(纯文本)'text/css'
(css文件)'text/javascript'
(js文件)'multipart/form-data'
(文件提交)'application/json'
(json传输)
'application/xml'
(xml文件)
注: 关键字MIME(Multipurpose Internet Mail Extensions)是指多用途互联网邮件扩展类型。
- 常用的Content-Type如下:
-
-
HttpResponse 子类
类型 作用 状态码 HttpResponseRedirect 重定响 301 HttpResponseNotModified 未修改 304 HttpResponseBadRequest 错误请求 400 HttpResponseNotFound 没有对应的资源 404 HttpResponseForbidden 请求被禁止 403 HttpResponseServerError 服务器错误 500
if result is None:
return HttpResponseRedirect("https://www.baidu.com")
# HttpResponseRedirect 重定向,上面这个是如果输入网址是错误的,那么就转到百度的网站
GET方式传参
-
GET请求方式中可以通过查询字符串(Query String)将数据传递给服务器
-
URL 格式:
xxx?参数名1=值1&参数名2=值2...
- 如:
http://127.0.0.1:8000/page1?a=100&b=200
- 如:
-
服务器端接收参数
-
判断 request.method 的值判断请求方式是否是get请求
if request.method == 'GET': 处理GET请求时的业务逻辑 else: 处理其它请求的业务逻辑
-
获取客户端请求GET请求提交的数据
- 语法
request.GET['参数名'] # QueryDict request.GET.get('参数名','默认值') request.GET.getlist('参数名') # mypage?a=100&b=200&c=300&b=400 # 原理:request.GET=QueryDict({'a':['100'], 'b':['200','400'], 'c':['300']}) # a = request.GET['a'] # b = request.GET['b'] # Error,b有两个值,所以会报错
QueryDict 的设计允许一个键对应多个值,这是因为 HTML 表单中的多个输入字段可以有相同的 name 属性,例如多个复选框。当这样的表单被提交时,服务器会接收到多个具有相同键的值。
为了处理这种情况,QueryDict 提供了 getlist() 方法,它可以返回一个包含所有值的列表。而 get() 方法则默认返回列表中的第一个值,这样就可以方便地处理通常情况下键只对应一个值的情况。
这是 Django 的一个设计决策,旨在让开发者能够轻松地处理表单数据,同时也能够处理复杂的情况,如多个相同名称的表单字段。当你使用 get() 方法时,Django 知道你可能只对第一个值感兴趣,所以它直接返回了列表中的第一个元素,而不是整个列表。如果你需要所有值,你应该使用 getlist() 方法。
- 能够产生get请求方式的场合
- 地址栏手动输入, 如: http://127.0.0.1:8000/mypage?a=100&b=200
<a href="地址?参数=值&参数=值">
- form表单中的method为get
<form method='get' action="/user/login"> 姓名:<input type="text" name="uname"> </form>
- 语法
-
一般查询字符串的大小会受到浏览器的的限制(不建议超过2048字节)
-
练习:
- 访问地址:http://127.0.0.1:8000/sum?start=整数&stop=整数&step整=字
- 输出结果为sum(range(start, step, stop)) 和:
- 如:
- 输入网址: http://127.0.0.1:8000/sum?start=1&stop=101&step=1
- 页面显示: 结果: 5050
- 输入网址: http://127.0.0.1:8000/sum?stop=101&step=2
- 页面显示: 结果: 2550
- 输入网址: http://127.0.0.1:8000/sum?start=1&stop=101&step=2
- 页面显示: 结果: 2500
-
收获:
1. for i in rang(start,end,step) 的使用 2. HttpResponse("结果是",sum) 这个在浏览器上会乱码 3. GET请求和前面的不一样,之前的都是在名字上进行命名匹配,获取信息数据,而GET 是在浏览器上直接对数据进行赋值,views进行获取
-
练习:
- 访问地址:http://127.0.0.1:8000/birthday?year=四位整数&month=整数&day=整数
- 最终输出: 生日为: xxxx年xx月xx日
- 如:
- 输入网址: http://127.0.0.1:8000/birthday?year=2015&month=12&day=11
- 显示为: 生日为:2015年12月11日
POST传递参数
- 客户端通过表单等POST请求将数据传递给服务器端,如:
<form method='post' action="/login">
姓名:<input type="text" name="username">
<input type='submit' value='登陆'>
</form>
-
服务器端接收参数
- 通过 request.method 来判断是否为POST请求,如:
if request.method == 'POST': 处理POST请求的数据并响应 else: 处理非POST 请求的响应
-
使用post方式接收客户端数据
- 方法
request.POST['参数名'] # request.POST 绑定QueryDict(和GET那个同样的结构{key:[value1,value2],....}) request.POST.get('参数名','') request.POST.getlist('参数名')
-
取消csrf验证,否则Django将会拒绝客户端发来的POST请求
-
取消 csrf 验证
- 删除 settings.py 中 MIDDLEWARE 中的 CsrfViewsMiddleWare 的中间件
MIDDLEWARE = [ ... # 'django.middleware.csrf.CsrfViewMiddleware', ... ]
解析: 浏览器--》客户端 我的代码--》服务端 第一步,浏览器访问地址,是GET请求,传送到服务器端 第二步,服务器端接收浏览器信息,返回一个html的表单给浏览器端,这个表单method是设定为post请求 第三步,浏览器端接收到代码端的表单(html),此时填写表单信息,点击提交/登陆等按钮,看>你表单怎么设计的,浏览器端就会发送到服务器端. 第四步:代码端接收到这个属于post的请求,对请求进行判断我,如果是post请求,做出对应操 作返回给浏览器端页面数据等 客户端:浏览器访问路由,出现表单,填入数据,服务端以post方式接收数据并进行访问 如果1:服务端以post方式接收数据,在访问的路由视图函数中,如果没有处理语句,就会报 ValueError at /login/ 如果2:csrf没有注释掉,那么会403,禁止访问
-
form 表单的name属性
-
在form表单控件提交数据时,会自动搜索本表单控件内部的子标签的name属性及相应的值,再将这些名字和值以键-值对的形式提交给action指定的服务器相关位置
-
在form内能自动搜集到的name属性的标签的控件有
<input name='xxx'> <select name='yyy'></select> # 单选框(就是下拉框选其一的那个框) <textarea name='zzz'></textarea> # 输入大量文本的框
- 如:
<form action="/page1" method="POST"> <input name="title" type="text" value="请输入"> <select name="gender"> <option value=1>男</option> <option value=0>女</option> </select> <textarea name="comment" rows="5" cols="10">附言...</textarea> <input type="submit" value="提交"> </form>