惊了！最通俗易懂的Djongo入门竟然在这里！

• Django简介

1. python下有多款不同的web框架，Django是最有代表行的一种。许多成功的网站和app都基于djanfo。
2. django是一个开源的web应用框架，由python写成。
3. django采用了MVC的软件设计模式，即模型M,视图V和控制器C。

• Django特点

1. 强大的数据库功能：用python的类继承，几行代码就可以拥有一个动态的数据库操作API，如果需要也能执行SQL语句。
2. 自带的强大的后台功能：几行代码就让网站拥有一个强大的后台，轻松管理内容。
3. 优雅的网址：用正则匹配网址，传递到对应函数。
4. 模板系统：强大，易扩展的模板系统，设计简易，代码和样式分开设计，更易管理。
5. 缓存系统：与memcached或其它缓存系统联用，表现更出色，加载速度更快。
6. 国际化：完全支持多语言应用，允许你定义翻译的字符，轻松翻译成不同国家的语言。

• Django项目目录

　　manage.py：用来管理当前项目的一个命令行工具

　　myproject/： 项目主文件夹

　　myproject/__init__.py：空文件，用来指明当前的myproject为一个可导入的模块包

　　myproject/settings.py：项目主要配置文件

　　myproject/urls.py：项目主要路由配置文件

　　myproject/wsgi.py：项目部署WSGI并发服务器时所需要的配置

• 安装Django

  • pip install django 默认安装最新版本
  • pip install django==2.0.4   (指定版本号安装）

 

• 创建项目

 

• • django-admin startproject mypro

创建好项目之后，我们进入项目文件夹中。用下面的命令就可以运行Django项目了。默认情况下，我们可以通过http://127.0.0.1:8000/来访问正在运行的项目。由于没有任何页面，所以会显示这么一个调试窗口。

• 开启开发服务器
  • cd myproject 　　　　                           进入项目目录
  • python manage.py runserver                 开启服务
  • python manage.py runserver 7000        改变服务监听端口
  • python manage.py runserver 0:8000       改变服务监听IP:端口

• 配置settings.py
  • BASE_DIR : 当前项目工作目录，用来在每一次开启项目时动态找到相关资源路径
  • SECRET_KEY : 加密的hash值以及保护某些签名数据的关键密钥
  • DEBUG : 调试模式
  • ALLOWED_HOSTS : 有哪些主机或域名可以访问当前django站点，如设置为*代表全部可访问。
  • INSTALL_APPS : django项目中所有使用的应用名称，自创建子应用也要加到这里，不然ORM数据库无法被识别到！
  • MIDDLEWARE : django中间件，用来在request或reponse过程中添加功能，比如确保安全性，传输保存Session等
  • SecurityMiddleware : xss脚本过滤，一些安全设置
  • SessionMiddleware : session支持中间件，在每次用户访问django项目时，添加session对每一个浏览器
  • CommonMiddleware : 通用组件，比如为路由添加末尾斜杠
  • CsrfViewMiddleware : 防跨站请求伪造令牌，为客户端添加csrf_token密钥，在表单提交时需提交该值
  • AuthenticationMiddleware : admin用户组件，每个request对象都会被添加admin下的user属性
  • MessageMiddleware : 消息中间件 展示一些后台消息给前端
  • XFrameOptionsMiddleware : 防止欺骗点击攻击出现；自身页面被嵌入到他人页面中，点击欺骗
  • ROOT_URLCONF : 主路由配置文件，字符串填写url.py文件路径
  • TEMPLATES : 模板文件配置项
  • WSGI_APPLICATION : WSGI服务器配置项，找到当前django下的wsgi引入APP文件
  • DATABASES : 数据库配置项，默认使用SQLite3，一个本地文件数据库
  • AUTH_PASSWORD_VALIDATORS : 检查用户密码强度的验证程序列表，不过是针对admin界面下的用户，而非自定义
  • LANGUAGE_CODE : django所使用语言文件
  • TIME_ZONE : django所使用时区
  • USE_I18N : 国际化支持 18表示Internationalization这个单词首字母I和结尾字母N之间的字母有18个
  • USE_L10N : 是localization的缩写形式，意即在l和n之间有10个字母
  • USE_TZ :开启了Time Zone功能，则所有的存储和内部处理，包括print显示的时间将是是UTC时间格式
  • STATIC_URL : URL访问静态资源时的路径
• 创建子应用
  • 项目和应用有啥区别？

应用是一个专门做某件事的网络应用程序——比如博客系统，或者公共记录的数据库，或者简单的投票程序。

项目则是一个网站使用的配置和应用的集合。项目可以包含很多个应用。应用可以被很多个项目使用

• 创建app

在Django项目中，app表示更小的一个功能单位，比方说在一个博客管理系统中，对博客的增删查改等功能就应该聚合在一个app中。进入项目目录中，用startapp命令创建app。

• • • cd mypro
    • django-admin startapp helloapp

• 页面和视图
  • 视图函数

打开app下的views.py文件Web访问起始就是通过一个URL连接地址访问到服务器上的一个函数在views.py中我们通过编写函数的形式，接收用户请求的request并返回一个response

 

# 每一个视图函数都需要有一个必须参数 request,用来接收用户访问时的请求内容
from django.http import HttpResponse
def index(request):
    return HttpResponse("<h1>Hello world</h1>

 

 　　　　HttpResponse函数用来像用户返回一个字符串。

• 路由配置

创建好了一个可以在请求时返回H1标签的视图函数，但是现在通过浏览器还是访问不到需要我们为这个app下的函数进行路由配置

• • 第一种简单的路由配置，直接在主控路由文件下，找到这个视图函数

#myproject/urls.py
from django.contrib import admin
from django.urls import path
from myapp import views
urlpatterns = [
    path('admin/', admin.site.urls),    #admin控制界面路由
    path('',views.index)
    #path函数第一个参数为访问地址，空字符串代表：当用户直接访问首页时
    #第二个参数代表访问该地址时对应的视图函数，我们引入了app下的views中的index视图函数。
]

 

　　　　　　接下来访问127.0.0.1:8000，那么你会看到一个非常大的Hello world。

• • 以上将视图函数的查找直接写到主控路由并不是最好的办法，我们的项目通常会有非常多的路由配置项，如果都堆到这个文件中肯定是非常乱的，难以维护；我们可以在对应app下创建一个子路由控制文件，并在其中设置视图的路由配置。

#myapp/urls.py
from django.urls import path
from . import views
urlpatterns = [
    path("",views.index)
]

 

• •  现在虽然配置了app下的路由文件，但是访问时，是看不到对应视图的结果这是因为默认的url查找动作将会从主控路由文件开始，我们还需要在主控路由文件下进行路由分发设置，让主控路由可以找到子app下的路由

#myproject/urls.py
from django.contrib import admin
from django.urls import path,include
from myapp import views
urlpatterns = [
    path('admin/',admin.site.urls),
    #path('',views.index)
    path('',include("myapp.urls")),
    # 函数 include() 允许引用其它 URLconfs
]

 

　　　　　　接下来再次尝试，在浏览器中访问主机域名；如果可以看到的话，恭喜你，效果已经很棒了！

 路由查找流程：

　　1. 查找主控路由文件下的 urlpatterns 全局变量，这是一个序列数据类型，其中每一个元素都是对应的一个路由匹配规则

　　2. 如果在规则中查找到符合匹配规则的，则执行其中的对应执行函数

　　3. 如果对应的不是一个执行函数，而是一个 include 路由包含，那么截断与此项匹配的 URL 的部分，并将剩余的路由字符串发送到 include所包含的子路由文件中以供进一步处理4. 如果没有匹配到的任何结果，django默认抛出 Page not found (404）

　　注意：Django的路由不考虑HTTP请求方式，仅根据URL进行路由，即，只要URL相同，无论POST、GET等哪种请求方式都指向同一个操作函数。

• path

path函数用来处理一个路由对应的事件

path(route, view, name)
#route： 匹配规则，是一个字符串
#view：对应的视图函数
#name：未来我们会用到他，用来为匹配规则命名，这样方便日后修改路由而不影响全局下的路由使用

• re_path

re_path是path函数的加强版；可以在re_path函数的第一个位置的字符串参数，写入一个标准Python正则表达式，其余参数与path相同

注意：匹配模式的最开头不需要添加/，因为默认情况下，每个url都带一个最前面的/，既然大家都有的部分，就不用浪费时间特别写一个了。

• 模板页面

　　返回一个字符串这肯定是不行的，太low了，也不好看，现在来返回一个正式的HTML页面。并在HTML页面中加入模板变量，由视图函数动态传递值；配置django中模板页面的保存路径，在项目目录下的settings.py文件中。

#myproject/settings.py
TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [os.path.join(BASE_DIR,'template')],     # 就是这一行设置静态模板路径
        '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'
             ],
          },
        },
]                    

 

创建template目录并在其中创建index.html文件。

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>hi</title>
</head>
<body>
    <h1>{{ message }}</h1>
</body>
</html>

　　 在HTML页面中，我们并没有明确指出H1标签的内容；通过一个{{ message }}来等待接收视图函数传来的数据，在HTML页面中这样的变量也叫做模板变量，常用双大括号语法。

　　接下来修改之前的视图函数，由视图函数传递变量给到HTML页面。

#myapp/views.py
from django.shortcuts import render
def index(request):
    #return HttpResponse("<h1>Hello world</h1>")
    content = {"message":"你好，世界" #此处的key值message对应页面中我们写的{{ message }}
        }
    return render(request,'index.html',content)

 

模板变量：

　　　　在django中的HTML页面，不光可以编写原本的标签等内容，还可以像Vue一样在页面中使用双大括号，来提前定义一些模板变量。模板变量可以由后台视图函数构建一个字典数据类型传递，字典的key是模板变量名，value值该模板变量对应的数据。当然，模板变量的内容远不止此，还会再后面继续为大家叙述。。。

•  为什么模板文件夹中还要在创建一个hello子文件夹呢？

这是由于django的文件搜索机制所导致的。当搜索模板文件的时候django会从所有app的templates文件夹中搜索，但是并不会区分它们，所以如果在多个app中有相同的文件名，django会使用找到的第一个。因此为了区分它们我们只能自己多创建一层文件夹用于区分。

• 页面中使用URL

当我们在页面中需要使用路径的时候，不要硬编码路径，最好使用url标签。例如下面这样的。

<a href="{% url 'hello' '张三' %}">你好，张三</a>

这里url标签中指定的名称是urls.py文件中路径的name参数。

path('hello/<str:name>', views.hello, name='hello')

当项目中存在多个app的时候，需要使用命名空间来区分。做法很简单，在urls.py文件中添加app_name属性。

app_name = 'hello' urlpatterns = [ path('', views.index, name='index'), path('hello/<str:name>', views.hello, name='hello') ]

然后在标签上添加用冒号分隔开的命名空间名称即可。

<a href="{% url 'hello:hello' '张三' %}">你好，张三</a>

• 静态文件

　　虽然有了模板页面，可以来展示一些标签的效果，但是整个HTML还是感觉很丑陋，所以，我们还要继续引入
一些类似css、img这样的静态资源，来装饰我们的页面。
　　在django中模板页面的静态资源使用，不能像之前写HTML代码直接引入，需要我们首先在项目中创建目录保
存对应的静态资源。

• • 在settings中配置静态文件保存目录，添加如下内容：

     　　　　有些静态文件可能是多个app公用的，这时候需要进行一点额外设置。首先在和app同级的目录创建static文件夹并将静态文件放入。然后在配置文件中添加额外的搜索路径配置。

　　　　　　　还是由于django文件搜索机制，我们最好在静态目录中添加一个public子文件夹和其他静态文件区分。

STATICFILES_DIRS = (
        os.path.join(BASE_DIR, 'static'),
)
# STATICFILES_DIRS 该配置项用来告诉django在查找静态资源时，应该访问哪个目录

• • 在项目中创建static目录，static目录下创建专门保存图片的img目录，在里面存一张图片1.jpg

文件结构类似下图：

 

　　需要注意的是，由于前面介绍的django文件搜索机制，在静态文件夹中，我们最好在指定一级和app同名的文件夹用来区分不同app间的静态文件。

• • 有了图片，接下来在模板页面中去引入并使用它，打开index.html进行修改：

<!DOCTYPE html>
<html lang="en">
    {% load staticfiles %}
<head>
    <meta charset="UTF-8">
    <title>hi</title>
</head>
<body>
    <h1>{{ message }}</h1>
    <img src='{% static "img/1.jpg" %}' alt="图片">
</body>
</html>

 

• • 这里用到了一个特殊语法： {% tag %} 这个叫静态标签，静态标签不同于模板变量，静态标签经常用来加载数据，或创建逻辑，比如之后我们要学到的 {% if %} ，使用静态标签可以方便我们在模板页面上实现某些只有在后台代码中才可以实现的逻辑功能。
  • 在页面中要引入静态资源，图片，CSS，JS文件，在引入时都需要通过 {% static "path" %} 来进行引入，并且在模板页面头部需要使用 {% load staticfiles %} 标签进行静态资源的加载。

• 模型数据库

有了以上内容的修饰，现在感觉还是缺少一些什么，我们在视图函数中为前端页面返回的是一个提前定义好的

变量，这显然在真正开发中是很少出现的，我们的数据大都来自于数据库中，那么现在需要我们在项目中加入

数据库，并且在视图函数中通过对数据库的访问来拿到数据

• • 创建数据库，这里使用项目自带的SQLite3数据库，默认已经是配好的，接下来需要我们进入到app下的models.py文件中，编写一个类，这个类就对应数据库中的一张表。

#myapp/models.py
from django.db import models
# Create your models here.
class Weather(models.Model):
    weather = models.CharField(max_length=100,verbose_name="天气")
    class Meta:verbose_name_plural = "天气"
    # 设置当前表名的一个可读的性更好的名字
    def __str__(self):
        return self.weather

 

• • 在这里我们使用到了django的orm映射关系用来创建数据库表，继承自django的models.Model类，一个类用来表示一张表，类中的一个属性代表一个字段，这里我们定义了一个类型为CharField，长度为100的字段，用来存储天气。

• • 下面的class Meta是模型类的元类，用来设置当前表的一些属性；这里我们使用verbose_name_plural属性设置当前表在admin后台查看时的名字

• •  在这里我们还定义了一个属于实例的函数__str__，用来描述当前数据在返回时的默认展示结果，为weather字段的值

• • django在创建模型类对应的数据表时，默认使用 应用名 加 下划线 加 模型类名 作为表的名字；比如当前Weather表名为：myapp_Weather

• • • orm映射关系，是django与数据库之间的一个桥梁，可以使开发者不再关注如何去编写SQL语句，直接通过一套ORM所提供的API接口即可方便对各种数据库进行交互。
  • 当某个子应用APP涉及到了数据库的使用时，要记得在settings文件中进行配置：

#myproject/settings.py
INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'myapp',
]

 

• • 接下来通过manage.py命令行管理工具提供的两条，创建我们所需要的数据。

• •  注意：默认django本身就已经需要一些数据的创建，所以我们在初次执行以下两条命令时可能会看到很多数据表和字段的创建，不要惊讶，这是正常的

python manage.py migrate     # 根据数据库迁移文件生成对应SQL语句并执行
# 初次执行是为了先把默认django需要的数据库创建出来
python manage.py makemigrations     # 创建数据库迁移文件
# 这次执行是为了创建APP中Weather模型类的迁移文件
python manage.py    # 将新添加的模型类迁移文件生成对应SQL并执行，实际创建出对应的Weathe表

如果提示结果正常，那么代表相应的数据表已经创建好了，接下来就需要我们去到django为我们提供的admin（数据库管理界面）来进行相关表的操作

• Django Admin

• • admin控制台是django为我们提供的一个非常便捷的用来管理数据库的界面。在主控路由文件下，其实你已经看到了它对应的路由设置：path('admin/', admin.site.urls),

• • • 进入admin界面，初次访问连接：127.0.0.1/admin，会提示我们输入账号密码，这是因为django的admin界面是需要一个超级管理员来登陆访问的，所以还需要我们创建对应的admin界面下的超级用户
    • 创建admin超级用户，使用manage.py命令行执行如下命令：

python manage.py createsuperuser

 

• • •  　　　　

Username (leave blank to use 'lienze'): root
Email address:
Password:Password (again):
This password is too short. It must contain at least 8 characters.
This password is too common.
This password is entirely numeric.
Password:
Password (again):
This password is too common.
This password is entirely numeric.
Password:
Password (again):
Superuser created successfully.

 

• • • 以上是我们创建超级用户的过程，非常坎坷；可以看到，在输入太短（不满足8位），或是只包含数字的简单密码，超级用户的创建都是被拒绝的所以我们把用户账号创建为 root ，而密码创建为 a1234567 ，接下来开启测试服务器，并通过创建好的超级用户登陆访问，如果幸运的话，你已经可以看到后台的admin界面啦admin界面已经展示出了默认django所使用的两张表，用户表和组表，用来保存当前管理后台的用户以及对应权限分组，可以点入用户表查看其中我们刚创建的root。

• 启动开发服务器
  

Django 的管理界面默认就是启用的。让我们启动开发服务器，看看它到底是什么样的。

如果开发服务器未启动，用以下命令启动它：

$ python manage.py runserver

 

现在，打开浏览器，转到你本地域名的 "/admin/" 目录， -- 比如 "http://127.0.0.1:8000/admin/" 。你应该会看见管理员登录界面：

• 进入管理站点页面
  

现在，试着使用你在上一步中创建的超级用户来登录。然后你将会看到 Django 管理页面的索引页：

你将会看到几种可编辑的内容：组和用户。它们是由 django.contrib.auth 提供的，这是 Django 开发的认证框架。

• admin注册表

虽然admin界面已经可以进来，但是为什么看不到刚才创建的Weather表呢，这是因为默认的表创建之后，还需要通过对应app下的 admin.py 文件进行admin后台注册，只有注册在这个文件中的模型类对应的表才可以在admin界面所看到

• • 在app下的admin.py文件中进行模型类的注册：

#myapp/admin.py
from django.contrib import admin
from myapp import models
admin.site.register(models.Weather)
#使用register函数接收模型类作为参数即可完成

注册成功之后，在服务器，通过浏览器访问 admin 界面，就可以看到创建好的Weather表了。

鼠标点击进去之后，就可以看到对应的表数据界面；右上角提供了可以添加功能的选项，试试给这个表来一些数据吧。

• • 例：

注意事项：

• 这个表单是从问题 Question 模型中自动生成的
• 不同的字段类型（日期时间字段 DateTimeField 、字符字段 CharField）会生成对应的 HTML 输入控件。每个类型的字段都知道它们该如何在管理页面里显示自己。
• 每个日期时间字段 DateTimeField 都有 JavaScript 写的快捷按钮。日期有转到今天（Today）的快捷按钮和一个弹出式日历界面。时间有设为现在（Now）的快捷按钮和一个列出常用时间的方便的弹出式列表。

页面的底部提供了几个选项：

• 保存（Save） - 保存改变，然后返回对象列表。
• 保存并继续编辑（Save and continue editing） - 保存改变，然后重新载入当前对象的修改界面。
• 保存并新增（Save and add another） - 保存改变，然后添加一个新的空对象并载入修改界面。
• 删除（Delete） - 显示一个确认删除页面。

如果显示的 “发布日期(Date Published)” 和你在 教程 1 里创建它们的时间不一致，这意味着你可能没有正确的设置 TIME_ZONE 。改变设置，然后重新载入页面看看是否显示了正确的值。

通过点击 “今天(Today)” 和 “现在(Now)” 按钮改变 “发布日期(Date Published)”。然后点击 “保存并继续编辑(Save and add another)”按钮。然后点击右上角的 “历史(History)”按钮。你会看到一个列出了所有通过 Django 管理页面对当前对象进行的改变的页面，其中列出了时间戳和进行修改操作的用户名：

• 视图操作模型

最终我们希望可以在视图函数中通过orm接口来访问到表中的数据，那么来打开视图文件吧，views.py

#myapp/views.py
from django.shortcuts import render
from myapp import models
def index(request):
    weathers = models.Weather.objects.all()
    content = {
        "weathers":weathers,
    }
    return render(request, 'index.html', content)

 

光返回是不行的，虽然我们绑定到了模板版变量的字典中，但是还得修改一下对应的要渲染的HTML页面:

<!DOCTYPE html>
<html lang="en">
    {% load staticfiles %}
<head>
    <meta charset="UTF-8">
    <title>hi</title>
</head>
<body>
    {% for weather in weathers %}
        <p>{{ weather }}</p>
    {% empty %}
        <p>没有任何天气</p>
    {% endfor %}
</body>
</html>

模板标签 {% for xxx in xxxs %} 可以用来在模板页面出迭代访问取出每一个数据，具体对于不同序列数据的访问我们会在后面详细为大家介绍， {% empty %} 标签用来判断当循环访问数据为空时要做的事情，最后循环标签要有 {% endfor %} 标签进行结束。因为HTML中并没有像Python缩进这样的方式来控制代码块。