0基础跟我学Django 教程----（1）

0基础跟我学Django 教程----（1）
📢

📢📢📣📣📣
哈喽！大家好，我是「奇点」，江湖人称 singularity。刚工作几年，想和大家一同进步🤝🤝
一位上进心十足的【Java ToB端大厂领域博主】！😜😜😜
喜欢java和python，平时比较懒，能用程序解决的坚决不手动解决😜😜😜

✨ 如果有对【java】感兴趣的【小可爱】，欢迎关注我

❤️❤️❤️感谢各位大可爱小可爱！❤️❤️❤️
————————————————

如果觉得本文对你有帮助，欢迎点赞，欢迎关注我，如果有补充欢迎评论交流，我将努力创作更多更好的文章。

目录

Django的前世今生：

安装Django（mac版本）

下载对应的tar包

解压

安装

第一个Django项目

1.视图和URL配置

path() 函数

2.Django模板

模板标签

变量

列表

字典

过滤器

if/else 标签

for 标签

ifequal/ifnotequal 标签

注释标签

include 标签

csrf_token

自定义标签和过滤器

配置静态文件

模板继承

父模板

子模板

Django的前世今生：

Python下有许多款不同的 Web 框架。Django是重量级选手中最有代表性的一位。许多成功的网站和APP都基于Django。

Django 是一个开放源代码的 Web 应用框架，由 Python 写成。

Django 遵守 BSD 版权，初次发布于 2005 年 7 月, 并于 2008 年 9 月发布了第一个正式版本 1.0

学习django之前还需要一些基础知识，例如python的知识和部分前端知识。同学如果对python不熟悉的话，可以学习我的0基础学python系列文章。

0基础，跟我一起学python---基础篇(1)_奇点_97的博客-CSDN博客

0基础,跟我一起学python--基础篇(2)_奇点_97的博客-CSDN博客

0基础,跟我一起学python--基础篇(3)_奇点_97的博客-CSDN博客

0基础跟我学python---进阶篇（1）_奇点_97的博客-CSDN博客

0基础跟我学python---进阶篇（2）python对数据库的操作_奇点_97的博客-CSDN博客

0基础跟我学python---进阶篇（3）python中的ORM框架（1）_奇点_97的博客-CSDN博客

0基础和我学python----SQLAlchemy框架（1）_奇点_97的博客-CSDN博客

不熟悉的同学，强烈建议学习一下python的基础知识和相关的进阶知识，否则就像我一样，刚从java转如到python的学习，开始真真是云里雾里的，一头包。当然大佬可以直接跳过这些。

python版本和Django也有要求，下面是推荐的版本

Django 版本 Python 版本
1.8 2.7, 3.2 , 3.3, 3.4, 3.5
1.9, 1.10 2.7, 3.4, 3.5
1.11 2.7, 3.4, 3.5, 3.6
2.0 3.4, 3.5, 3.6, 3.7
2.1, 2.2 3.5, 3.6, 3.7

安装Django（mac版本）

下载对应的tar包

从这里下载最新的稳定版本：DJango-3xx.y.tar.gz，在页面右侧列表下载，如下图：

记住是最新的官方版本哦。其中 x.y 是版本号。进入你下载该文件的文件夹目录，执行如下命令:（Mac下默认是/Users/xxx/Downloads，xxx是你的用户名）

解压
```
tar zxvf Django-3.x.y.tar.gz
```
你也可以从 Github 上下载最新版，地址：GitHub - django/django: The Web framework for perfectionists with deadlines.：
```
git clone https://github.com/django/django.git
```
安装

进入解压后的目录：
```
cd Django-3.x.y
sudo python setup.py install
```
安装成功后会输出以下信息：
```
Processing dependencies for Django==3.x.y
Finished processing dependencies for Django==3.x.y
```
再进入我们的站点目录，创建 Django 项目：
```
django-admin.py startproject HelloWorld
```
第一个Django项目

使用 django-admin 来创建 HelloWorld 项目：
```
django-admin startproject HelloWorld
```
下面是项目的目录结构

目录说明：
- HelloWorld: 项目的容器。
- manage.py: 一个实用的命令行工具，可让你以各种方式与该 Django 项目进行交互。
- HelloWorld/__init__.py: 一个空文件，告诉 Python 该目录是一个 Python 包。
- HelloWorld/asgi.py: 一个 ASGI 兼容的 Web 服务器的入口，以便运行你的项目。
- HelloWorld/settings.py: 该 Django 项目的设置/配置。
- HelloWorld/urls.py: 该 Django 项目的 URL 声明; 一份由 Django 驱动的网站"目录"。
- HelloWorld/wsgi.py: 一个 WSGI 兼容的 Web 服务器的入口，以便运行你的项目。
接下来我们进入 HelloWorld 目录输入以下命令，启动服务器：
```
python3 manage.py runserver 0.0.0.0:8000
```
0.0.0.0 让其它电脑可连接到开发服务器，8000 为端口号。如果不说明，那么端口号默认为 8000。

在浏览器输入你服务器的 ip（这里我们输入本机 IP 地址： 127.0.0.1:8000）及端口号，如果正常启动，输出结果如下：

1.视图和URL配置

在先前创建的 HelloWorld 目录下的 HelloWorld 目录新建一个 views.py 文件，并输入代码：
```
from django.http import HttpResponse
 
def hello(request):
    return HttpResponse("Hello world ! ")
```
接着，绑定 URL 与视图函数。打开 urls.py 文件，删除原来代码，将以下代码复制粘贴到 urls.py 文件中：
```
from django.conf.urls import url
 
from . import views
 
urlpatterns = [
    url(r'^$', views.hello),
]
```
或者用下面的方法修改
```
from django.urls import path
 
from . import views
 
urlpatterns = [
    path('hello/', views.hello),
]
```
通过浏览器打开 http://127.0.0.1:8000/hello，输出结果如下：

注意：项目中如果代码有改动，服务器会自动监测代码的改动并自动重新载入，所以如果你已经启动了服务器则不需手动重启。

path() 函数

Django path() 可以接收四个参数，分别是两个必选参数：route、view 和两个可选参数：kwargs、name。

语法格式：
```
path(route, view, kwargs=None, name=None)
```
- route: 字符串，表示 URL 规则，与之匹配的 URL 会执行对应的第二个参数 view。
- view: 用于执行与正则表达式匹配的 URL 请求。
- kwargs: 视图使用的字典类型的参数。
- name: 用来反向获取 URL。
```
path('hello/', views.hello),
```
Django2. 0中可以使用 re_path() 方法来兼容 1.x 版本中的 url() 方法，一些正则表达式的规则也可以通过 re_path() 来实现。
```
from django.urls import include, re_path
 
urlpatterns = [
    re_path(r'^index/$', views.index, name='index'),
    re_path(r'^bio/(?P\w+)/$', views.bio, name='bio'),
    re_path(r'^weblog/', include('blog.urls')),
    ...
]
```
2.Django模板

在上一节中我们使用 django.http.HttpResponse() 来输出 "Hello World！"。该方式将数据与视图混合在一起，不符合 Django 的 MVC 思想。

本章节我们将为大家详细介绍 Django 模板的应用，模板是一个文本，用于分离文档的表现形式和内容。

下面我们在外层HelloWorld文件夹中创建一个test.html文件，文件结构如下

html页面如下
```
html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Titletitle>
head>
<body>
<h1>{{ hello }}h1>
 
body>
html>
```
从模板中我们知道变量使用了双括号。

接下来我们需要向Django说明模板文件的路径，修改HelloWorld/settings.py，修改 TEMPLATES 中的 DIRS 为 [os.path.join(BASE_DIR, 'templates')]，如下所示:
```
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',
            ],
        },
    },
]
```
我们现在修改 views.py，增加一个新的对象，用于向模板提交数据：

HelloWorld/HelloWorld/views.py 文件代码：
```
"""
模版
"""
from django.shortcuts import render
 
 
def test(request):
    context = {}
    context['hello'] = 'Hello World!'
    return render(request, 'test.html', context)
```
HelloWorld/HelloWorld/urls.py 文件代码：
```
"""
模板
"""
from django.urls import path
 
from . import views
 
urlpatterns = [
    path('test/', views.test),
]
```
可以看到，我们这里使用 render 来替代之前使用的 HttpResponse。render 还使用了一个字典 context 作为参数。

context 字典中元素的键值 hello 对应了模板中的变量 {{ hello }}。

再次访问 http://127.0.0.1:8000/runoob，可以看到页面：

这样我们就完成了使用模板来输出数据，从而实现数据与视图分离。

接下来我们将具体介绍模板中常用的语法规则。

view.py的

html的

html的变量名必须和view的变量名一致。

模板标签

变量

模板语法：
```
view：｛"HTML变量名" : "views变量名"｝
HTML：｛｛变量名｝｝
```
view
```
"""
模板标签
"""
from django.shortcuts import render
 
 
# 这里是访问的地址 localhost:8080/test
def test(request):
    views_name = "测试"
    return render(request, "test.html", {"name": views_name})
```
url
```
from django.urls import path
 
from . import views
 
urlpatterns = [
    path('test/', views.test),
]
```
html
```
html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Titletitle>
head>
<body>
<h1>{{ hello1 }}h1>
<p>{{ name }}p>
body>
html>
```
结果

列表

templates 中的.html中，可以用 . 索引下标取出对应的元素。

注意：url-->view方法中的test方法 -->test.html
```
from django.shortcuts import render
 
def test(request):
    views_list = ["教程1","教程2","教程3"]
    return render(request, "test.html", {"views_list": views_list})
```
html中的东西

{{ views_list }}
# 取出整个列表

{{ views_list.0 }}
# 取出列表的第一个元素

再次访问 http://127.0.0.1:8000/test，可以看到页面：

字典

templates 中的 .html中，可以用 .键取出对应的值。
```
from django.shortcuts import render
 
def test(request):
    views_dict = {"name":"菜鸟教程"}
    return render(request, "test.html", {"views_dict": views_dict})
```
过滤器

模板语法：
```
{{ 变量名 | 过滤器：可选参数 }}
```
模板过滤器可以在变量被显示前修改它，过滤器使用管道字符，如下所示：
```
{{ name|lower }}
```
{{ name }} 变量被过滤器 lower 处理后，文档大写转换文本为小写。

过滤管道可以被* 套接* ，既是说，一个过滤器管道的输出又可以作为下一个管道的输入：
```
{{ my_list|first|upper }}
```
以上实例将第一个元素并将其转化为大写。

有些过滤器有参数。过滤器的参数跟随冒号之后并且总是以双引号包含。例如：
```
{{ bio|truncatewords:"30" }}
```
这个将显示变量 bio 的前30个词。

其他过滤器：
- addslashes : 添加反斜杠到任何反斜杠、单引号或者双引号前面。
- date : 按指定的格式字符串参数格式化 date 或者 datetime 对象，实例：
```
{{ pub_date|date:"F j, Y" }}
```
- length : 返回变量的长度。
default

default 为变量提供一个默认值。

如果 views 传的变量的布尔值是 false，则使用指定的默认值。

以下值为 false：
```
0  0.0  False  0j  ""  []  ()  set()  {}  None
```
view
```
"""
默认值
"""
from django.shortcuts import render
 
 
def test(request):
    name = 0
    return render(request, "test.html", {"name": name})
```
html

{{ name|default:"卧室真大" }}

length

返回对象的长度，适用于字符串和列表。

字典返回的是键值对的数量，集合返回的是去重后的长度。
```
from django.shortcuts import render
 
def test(request):
    name ="菜鸟教程"
    return render(request, "test.html", {"name": name})
```
{{ name|length}}

filesizeformat

以更易读的方式显示文件的大小（即'13 KB', '4.1 MB', '102 bytes'等）。

字典返回的是键值对的数量，集合返回的是去重后的长度。
```
from django.shortcuts import render
 
def test(request):
    num=1024
    return render(request, "test.html", {"num": num})
```
date

根据给定格式对一个日期变量进行格式化。

格式 Y-m-d H:i:s返回 年-月-日小时:分钟:秒 的格式时间。
```
from django.shortcuts import render
 
def test(request):
    import datetime
    now  =datetime.datetime.now()
    return render(request, "test.html", {"time": now})
```
{{ time|date:"Y-m-d" }}

truncatechars

如果字符串包含的字符总个数多于指定的字符数量，那么会被截断掉后面的部分。

截断的字符串将以 ... 结尾。
```
def test(request):
    views_str = "菜鸟教程"
    return render(request, "test.html", {"views_str": views_str})
```
{{ views_str|truncatechars:2}}

safe

将字符串标记为安全，不需要转义。

要保证 views.py 传过来的数据绝对安全，才能用 safe。

和后端 views.py 的 mark_safe 效果相同。

Django 会自动对 views.py 传到HTML文件中的标签语法进行转义，令其语义失效。加 safe 过滤器是告诉 Django 该数据是安全的，不必对其进行转义，可以让该数据语义生效。
```
from django.shortcuts import render
 
def test(request):
    views_str = "点击跳转"
    return render(request, "test.html", {"views_str": views_str})
```
html

{{ views_str|safe }}

if/else 标签

基本语法格式如下：
```
{% if condition %}
     ... display
{% endif %}
```
当有多个条件的时候
```
{% if condition1 %}
   ... display 1
{% elif condition2 %}
   ... display 2
{% else %}
   ... display 3
{% endif %}
```
根据条件判断是否输出。if/else 支持嵌套。

{% if %} 标签接受 and ， or 或者 not 关键字来对多个变量做判断，或者对变量取反（ not )，例如：
```
{% if athlete_list and coach_list %}
     athletes 和 coaches 变量都是可用的。
{% endif %}
```
例子如下：
```
def test(request):
    views_num = 88
    return render(request, "test.html", {"num": views_num})
```
```
{%if num > 90 and num <= 100 %}
优秀
{% elif num > 60 and num <= 90 %}
合格
{% else %}
一边玩去～
{% endif %}
```
结果：

for 标签

{% for %} 允许我们在一个序列上迭代。

与 Python 的 for 语句的情形类似，循环语法是 for X in Y ，Y 是要迭代的序列而 X 是在每一个特定的循环中使用的变量名称。

每一次循环中，模板系统会渲染在 {% for %} 和 {% endfor %} 之间的所有内容。

例如，给定一个运动员列表 athlete_list 变量，我们可以使用下面的代码来显示这个列表：
```
<ul>
{% for athlete in athlete_list %}
    <li>{{ athlete.name }}li>
{% endfor %}
ul>
```
```
def runoob(request):
    views_list = ["运动员1","运动员2","运动员3","运动员4",]
    return render(request, "test.html", {"views_list": views_list})
```
给标签增加一个 reversed 使得该列表被反向迭代：
```
{% for athlete in athlete_list reversed %}
...
{% endfor %}
```
```
{% for i in views_list  reversed%}
{{ i }}
{% endfor %}
```
字典的遍历：
```
def runoob(request):
    views_dict = {"name":"xiaoming","age":18}
    return render(request, "test.html", {"views_dict": views_dict})
```
```
{% for i,j in views_dict.items %}
    {{ i }}---{{ j }}
{% endfor %}
```
在 {% for %} 标签里可以通过 {{forloop}} 变量获取循环序号。
- forloop.counter: 顺序获取循环序号，从 1 开始计算
- forloop.counter0: 顺序获取循环序号，从 0 开始计算
- forloop.revcounter: 倒序获取循环序号，结尾序号为 1
- forloop.revcounter0: 倒序获取循环序号，结尾序号为 0
- forloop.first（一般配合if标签使用）: 第一条数据返回 True，其他数据返回 False
- forloop.last（一般配合if标签使用）: 最后一条数据返回 True，其他数据返回 False
```
def test(request):
     views_list = ["a", "b", "c", "d", "e"]
     return render(request, "test.html", {"listvar": views_list})
```
```
{% for i in listvar %}
    {{ forloop.counter }}
    {{ forloop.counter0 }}
    {{ forloop.revcounter }}
    {{ forloop.revcounter0 }}
    {{ forloop.first }}
    {{ forloop.last }}
{% endfor %}
```
{% empty %}

可选的 {% empty %} 从句：在循环为空的时候执行（即 in 后面的参数布尔值为 False ）。
```
ef test(request):
  views_list = []
  return render(request, "test.html", {"listvar": views_list})
```
```
{% for i in listvar %}
    {{ forloop.counter0 }}
{% empty %}
    空空如也～
{% endfor %}
```
可以嵌套使用 {% for %} 标签：
```
{% for athlete in athlete_list %}
    {{ athlete.name }}
    
    {% for sport in athlete.sports_played %}
        
{{ sport }}
```
{% endfor %}

Django 版本	Python 版本
1.8	2.7, 3.2 , 3.3, 3.4, 3.5
1.9, 1.10	2.7, 3.4, 3.5
1.11	2.7, 3.4, 3.5, 3.6
2.0	3.4, 3.5, 3.6, 3.7
2.1, 2.2	3.5, 3.6, 3.7

{% endfor %}

ifequal/ifnotequal 标签

{% ifequal %} 标签比较两个值，当他们相等时，显示在 {% ifequal %} 和 {% endifequal %} 之中所有的值。

下面的例子比较两个模板变量 user 和 currentuser :


{% ifequal user currentuser %}
    <h1>Welcome!h1>
{% endifequal %}

和 {% if %} 类似， {% ifequal %} 支持可选的 {% else%} 标签：8


{% ifequal section 'sitenews' %}
    <h1>Site Newsh1>
{% else %}
    <h1>No News Hereh1>
{% endifequal %}

注释标签

Django 注释使用 {# #}。

{# 这是一个注释 #}

include 标签

{% include %} 标签允许在模板中包含其它的模板的内容。

下面这个例子都包含了 nav.html 模板：

{% include "nav.html" %}

csrf_token

csrf_token 用于form表单中，作用是跨站请求伪造保护。

如果不用 {% csrf_token %} 标签，在用 form 表单时，要再次跳转页面会报 403 权限错误。

用了{% csrf_token %} 标签，在 form 表单提交数据时，才会成功。

解析：

首先，向服务器发送请求，获取登录页面，此时中间件 csrf 会自动生成一个隐藏input标签，该标签里的 value 属性的值是一个随机的字符串，用户获取到登录页面的同时也获取到了这个隐藏的input标签。

然后，等用户需要用到form表单提交数据的时候，会携带这个 input 标签一起提交给中间件 csrf，原因是 form 表单提交数据时，会包括所有的 input 标签，中间件 csrf 接收到数据时，会判断，这个随机字符串是不是第一次它发给用户的那个，如果是，则数据提交成功，如果不是，则返回403权限错误。

自定义标签和过滤器

1、在应用目录下创建 templatetags 目录(与 templates 目录同级，目录名只能是 templatetags)。

HelloWorld/
|-- HelloWorld
|   |-- __init__.py
|   |-- __init__.pyc
|   |-- settings.py
...
|-- manage.py
`-- templatetags
`-- templates

2、在 templatetags 目录下创建任意 py 文件，如：my_tags.py。

3、my_tags.py 文件代码如下：


from django import template
 
register = template.Library()   #register的名字是固定的,不可改变

修改 settings.py 文件的 TEMPLATES 选项配置，添加 libraries 配置：


...
TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [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',
            ],
            "libraries":{                          # 添加这边三行配置
                'my_tags':'templatetags.my_tags'   # 添加这边三行配置        
            }                                      # 添加这边三行配置
        },
    },
]

4、利用装饰器 @register.filter 自定义过滤器。

注意：装饰器的参数最多只能有 2 个。


@register.filter
def my_filter(v1, v2):
    return v1 * v2

5、利用装饰器 @register.simple_tag 自定义标签。


@register.simple_tag
def my_tag1(v1, v2, v3):
    return v1 * v2 * v3

6、在使用自定义标签和过滤器前，要在 html 文件 body 的最上方中导入该 py 文件。

{% load my_tags %}

7、在 HTML 中使用自定义过滤器。

{{ 11|my_filter:22 }}

8、在 HTML 中使用自定义标签。

{% my_tag1 11 22 33 %}

9、语义化标签

在该 py 文件中导入 mark_safe。

from django.utils.safestring import mark_safe

定义标签时，用上 mark_safe 方法，令标签语义化，相当于 jQuery 中的 html() 方法。

和前端HTML文件中的过滤器 safe 效果一样。'


@register.simple_tag
def my_html(v1, v2):
    temp_html = "" %(v1, v2)
    return mark_safe(temp_html)

在HTML中使用该自定义标签，在页面中动态创建标签。

{% my_html "zzz" "xxx" %}

配置静态文件

1、在项目根目录下创建 statics 目录。

2、在 settings 文件的最下方配置添加以下配置：

STATIC_URL = '/static/' # 别名 
STATICFILES_DIRS = [ 
    os.path.join(BASE_DIR, "statics"), 
]

3、在 statics 目录下创建 css 目录，js 目录，images 目录，plugins 目录，分别放 css文件，js文件，图片，插件。

4、把 bootstrap 框架放入插件目录 plugins。

5、在 HTML 文件的 head 标签中引入 bootstrap。

注意：此时引用路径中的要用配置文件中的别名 static，而不是目录 statics。



在模板中使用需要加入 {% load static %} 代码，以下实例我们从静态目录中引入图片。


from django.shortcuts import render
 
def test(request):
    name ="test"
    return render(request, "test.html", {"name": name})

{% load static %} {{name}}

模板继承

模板可以用继承的方式来实现复用，减少冗余内容。

网页的头部和尾部内容一般都是一致的，我们就可以通过模板继承来实现复用。

父模板用于放置可重复利用的内容，子模板继承父模板的内容，并放置自己的内容。

父模板

标签 block...endblock: 父模板中的预留区域，该区域留给子模板填充差异性的内容，不同预留区域名字不能相同。


{% block 名称 %} 
预留给子模板的区域，可以设置设置默认内容
{% endblock 名称 %}

子模板

子模板使用标签 extends 继承父模板：

{% extends "父模板路径"%}

子模板如果没有设置父模板预留区域的内容，则使用在父模板设置的默认内容，当然也可以都不设置，就为空。

子模板设置父模板预留区域的内容：


{ % block 名称 % }
内容 
{% endblock 名称 %}

接下来我们先创建之前项目的 templates 目录中添加 base.html 文件，代码如下：


html>
<html>
<head>
<meta charset="utf-8">
<title>123w(baidu.com)title>
head>
<body>
    <h1>Hello World!h1>
    <p> Django 测试。p>
    {% block mainbody %}
       <p>originalp>
    {% endblock %}
body>
html>

以上代码中，名为 mainbody 的 block 标签是可以被继承者们替换掉的部分。

所有的 {% block %} 标签告诉模板引擎，子模板可以重载这些部分。

test.html 中继承 base.html，并替换特定 block，test.html 修改后的代码如下：


 {%extends "base.html" %}
 
{% block mainbody %}
<p>继承了 base.html 文件p>
{% endblock %}

第一行代码说明 test.html 继承了 base.html 文件。可以看到，这里相同名字的 block 标签用以替换 base.html 的相应 block。

又是一篇万字的长篇大论，，希望读者能给耐心读完，相信读完你一定会有所收获。为自己点个赞吧

如果觉得本文对你有帮助，欢迎点赞，欢迎关注我，如果有补充欢迎评论交流，我将努力创作更多更好的文章。

Django的前世今生：

安装Django（mac版本）

下载对应的tar包

解压

安装

第一个Django项目

1.视图和URL配置

path() 函数

2.Django模板

模板标签

变量

列表

字典

过滤器

if/else 标签

for 标签

{{ athlete.name }}