环境搭建
Django的具体内容可以到官网查看
Django官网
Django安装
详情可参考官网安装介绍
具体需要安装哪个版本的Django,可以参考这里,这里列出了Django与python的兼容版本,请自行选择。
1. pip包管理器安装(最方便 推荐)
pip install Django==2.1.7
2. 源码安装
git clone https://github.com/django/django.git
下载源码,然后进入根目录执行python setup.py install
即可
是否安装成功可是用以下命令检测:
python -m django --version
或者进入python命令行中,导入Django,如果不报错即安装成功
import django
创建项目及应用
创建项目
1. 打开终端进入想要创建项目的目录
2. 执行命令 django-admin startproject blog
3. 如果没有报错,即项目创建成功
项目目录结构
项目创建成功后我们可以发现,在原先的路径下多出了一个blog的文件夹,并且其内部还自动生成了若干文件和文件夹。
项目目录结构
manage.py // 项目管理器 执行python manage.py可以查看所有命令
blog // 项目容器,包含项目的一些基本配置文件信息
__init__.py // python中声明模块的文件,默认为空
settings.py // 项目的总配置文件,包含了数据库、web应用、时间等配置信息
urls.py // url配置文件,Django项目中所有页面地址都需要在此配置
wsgi.py // python服务器网管接口 全称:Python Web Server Gateway Interface
启动项目服务器
python manage.py runserver
默认使用8000端口号
或
python manage.py runserver 9999
自定义端口号
在执行以上启动服务的命令时,python会先对项目进行检查,之后再启动。
这个时候我们就可以在浏览器中通过 127.0.0.1:8000
来访问了
创建应用
1. 打开终端进入项目中manage.py同级目录
2. 执行命令: python manage.py startapp blog
3. 添加应用名到settings.py配置文件中的INSTALLED_APPS中,如下图所示
应用目录结构
migrations // 数据移植模块,内容自动生成
__init__.py
__init__.py
admin.py // 该应用的后台管理系统配置
apps.py // 当前应用的一些配置
models.py // 数据模型模块,使用ORM框架
tests.py // 自动化测试模块,在这里编写测试脚本
views.py // 执行响应的代码模块,项目中大部分代码均在这里编写(代码逻辑处理的主要地点)
创建第一个响应页面
1. 编辑blog.views.py文件
from django.shortcuts import render
from django.http import HttpResponse
def index(request):
return HttpResponse('Hello World!')
2. 配置urls.py
import blog.views as hv
urlpatterns = [
url(r'^admin/', admin.site.urls),
url(r'^index/', hv.index)
]
此时再次访问 127.0.0.1:8000/index/
时即可看到页面上显示出Hello World!
。
注意:
编辑blog.views.py
- 中每个响应对应一个函数,函数必须返回一个响应
- 中函数必须存在一个参数,一般约定为request
- 中每个响应(函数)对应一个URL
编辑urls.py
- 每个URL都以url的形式写出来
- url函数放在urlpatterns列表中
- url函数包含三个参数:URL(正则)、对应方法(响应函数名称)、名称
URL的另一种配置方式
1. 在根urls.py中引入include
2. 在APP目录下创建urls.py文件,格式与根urls.py相同
3. 根urls.py中url函数的第二个参数改为include( 'blog.urls')
即:
这样做的主要目的是为了防止在大型项目中,根urls.py文件配置杂乱、臃肿而不易维护,将其每个页面的url配置分散到每个应用中的urls.py中。
Templates介绍
Templates说白了就是HTML文件,主要使用了Django模板语言(Django Template Language , DTL)
开发第一个Template
1. 在APP的根目录下创建名叫Templates的目录
2. 在该目录下再创建一个以该APP应用名为名的目录(假设在blogAPP下创建了Templates目录,再在Templates目录下创建blog目录),这里是为了防止多个APP引用各自Templates目录下同名模板引发的引用错乱。
3. 在views.py中返回render()
render()函数支持一个dict类型的参数
该字典是后台传递到模板文件的参数,键为参数名
在模板中使用{{ 参数名 }}来直接使用
如下:
Models介绍
通常,一个model对应数据库的一张数据表
Django中的Model以类的形式表现
其中包含了一些基本字段以及数据的一些行为
编写Model
1. 在应用根目录下创建models.py,并引入models模块
2. 创建类,集成models.Model,该类即是一张数据表
3. 在类中创建字段
字段创建
字段即类里面的属性(变量)
字段创建参考这里
attr = models.CharField(max_length = 64)
attr1 = models.TextField()
生成数据表
1. 终端进入manage.py同级目录
2. 执行命令 python manage.py makemigrations APP名(可选)
(如果跟上APP名字,则表示只该APP下生成数据迁移;否则该项目下所有的应用都生成数据迁移)
3. 再执行命令 python manage.py migrate
根据终端输出可以知道,执行命令不仅仅只生成了blog.0001_initial...
,还生成了很多的auth开头的和admin开头的东东,关于这些具体是什么,我们可以从项目根目录中的settings.py中的INSTALLED_APPS
中可以略知一二,在INSTALLED_APPS
中除了我们自己添加的blog
之外,剩余的都是系统自带的。
执行完毕后,Django会自动在app/migrations
目录下生成移植文件,如下:
# -*- coding: utf-8 -*-
# Generated by Django 1.11.18 on 2019-02-20 14:12
from __future__ import unicode_literals
from django.db import migrations, models
class Migration(migrations.Migration):
initial = True
dependencies = [
]
operations = [
migrations.CreateModel(
name='Article',
fields=[
('id', models.AutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
('title', models.CharField(default='Title', max_length=32)),
('content', models.TextField(null=True)),
],
),
]
从以上自动生成的移植文件中可知,Django除了为我们生成了我们定义的title
和content
外,还添加了id
作为Article表的主键且自增。
执行python manage.py sqlmigrate 应用名 文件id
可以查看SQL语句,如下:
当然也可以借助三方软件来查看根目录下的db.sqlite3数据库文件并通过可视化三方工具向数据库blog_article数据表中添加若干条数据。
获取数据库中的数据并展示到页面
1. blog.views.py中 import models
2. 获取数据 article = models.Article.objects.get(pk = 1)
3. 函数返回数据 return render(request, 'blog/index.html', {'article' : article})
4. 前端模板中直接使用{{ article.title }}
、{{ article.content }}
即可获取到数据
自带Admin后台介绍
Admin是Django自带的一个功能强大的自动化数据管理界面
被授权的用户可以直接在Admin中管理数据库
Django提供了很多针对Admin的定制功能
创建用户
终端在manage.py同级目录执行命令 python manage.py createsuperuser
localhost:8000/admin
即为后台管理入口
可以更改settings.py中的LANGUAGE_CODE = 'zh_Hans'
即为显示汉语。
定制显示自己创建的blogAPP的Article数据表
1. 在应用下admin.py中引入自身的models模块
2. 编辑admin.py admin.site.register(models.Article)
修改数据默认显示名称
1. 在Article类下添加一个方法
2. 根据Python版本选择__str__(self)
或者__unicode__(self)
3. return self.title
# -*- coding: utf-8 -*-
from __future__ import unicode_literals
from django.db import models
class Article(models.Model):
title = models.CharField(max_length = 32, default = 'Title')
content = models.TextField(null = True)
def __unicode__(self):
return self.title