Django是基于Python的重量级开源Web框架。Django拥有高度定制的ORM和大量的API,简单灵活的视图编写、优雅的url、适用于快速开发的模板以及强大的管理后台。
Django简介可以查看菜鸟教程
Django 简介 | 菜鸟教程
当我们更换镜像源进行pip 安装时,可能会出现报错:ERROR: Cannot determine archive format of :XXXXXXXXXX需要 通过设置 --trusted-host pypi.douban.com 信任该镜像源。
C:\Users\zhangyy>
C:\Users\zhangyy>pip install django==3.2.13 https://mirrors.aliyun.com/pypi/simple/
Collecting https://mirrors.aliyun.com/pypi/simple/
Downloading https://mirrors.aliyun.com/pypi/simple/ (21.0 MB)
---------------------------------------- 21.0/21.0 MB 8.1 MB/s eta 0:00:00
ERROR: Cannot unpack file C:\Users\zhangyy\AppData\Local\Temp\pip-unpack-ypvyb0uw\simple (downloaded from C:\Users\zhangyy\AppData\Local\Temp\pip-req-build-0wx0y5_x, content-type: text/html; charset=utf-8); cannot detect archive format
ERROR: Cannot determine archive format of C:\Users\zhangyy\AppData\Local\Temp\pip-req-build-0wx0y5_x
C:\Users\zhangyy>pip install -i https://pypi.douban.com/simple --trusted-host pypi.douban.com Django==4.1.3
Looking in indexes: https://pypi.douban.com/simple
Collecting Django==4.1.3
Downloading https://pypi.doubanio.com/packages/4f/be/cd28514516e66c40b87e487be68cf61a1637bd3ec60a2db90bb5075a2df5/Django-4.1.3-py3-none-any.whl (8.1 MB)
---------------------------------------- 8.1/8.1 MB 2.5 MB/s eta 0:00:00
Collecting asgiref<4,>=3.5.2
Downloading https://pypi.doubanio.com/packages/af/6d/ea3a5c3027c3f14b0321cd4f7e594c776ebe64e4b927432ca6917512a4f7/asgiref-3.5.2-py3-none-any.whl (22 kB)
Collecting sqlparse>=0.2.2
Downloading https://pypi.doubanio.com/packages/97/d3/31dd2c3e48fc2060819f4acb0686248250a0f2326356306b38a42e059144/sqlparse-0.4.3-py3-none-any.whl (42 kB)
---------------------------------------- 42.8/42.8 kB 2.0 MB/s eta 0:00:00
Collecting tzdata
Downloading https://pypi.doubanio.com/packages/61/1e/3c4bf37f8d6ceba07ae357e70eedd21bd15a032b460bab6b12a58c0fce9d/tzdata-2022.6-py2.py3-none-any.whl (338 kB)
---------------------------------------- 338.8/338.8 kB 7.1 MB/s eta 0:00:00
Installing collected packages: tzdata, sqlparse, asgiref, Django
Successfully installed Django-4.1.3 asgiref-3.5.2 sqlparse-0.4.3 tzdata-2022.6
现在安装成功了。
自动创建的项目中的文件有以下这些:
manage.py:Django程序执行的入口
db.sqlite3:SQLite的数据库文件,Django默认使用这种小型数据库存取数据,非必须
templates:Django生成的HTML模板文件夹,也可以在每个App中使用模板文件夹
djangoProject:Django生成的和项目同名的配置文件夹
settings.py:Django总的配置文件,可以配置App、数据库、中间件、模板等诸多选项
urls.py:Django默认的路由配置文件
wsgi.py:Django实现的WSGI接口的文件,用来处理Web请求
运行该项目
进入pycharm命令行,发现有个报错:
无法加载文件\venv\Scripts\activate.ps1,因为在此系统上禁止运行脚本。
无法加载文件 C:\Users\zhangyy\PycharmProjects\djangoProject\venv\Scripts\activate.ps1,因为在此系统上禁止运行脚本。有关详细信息,请参阅 https:/go.microsoft.com/fwlink/?Lin
kID=135170 中的 about_Execution_Policies。
+ CategoryInfo : SecurityError: (:) [],ParentContainsErrorRecordException
+ FullyQualifiedErrorId : UnauthorizedAccess
PS C:\Users\zhangyy\PycharmProjects\djangoProject> get-executionpolicy
Restricted
打开Windows Powershall在windows以管理员的身份运行,命令窗口输入set-executionpolicy remotesigned,回车,输入Y。
Windows PowerShell
版权所有(C) Microsoft Corporation。保留所有权利。
安装最新的 PowerShell,了解新功能和改进!https://aka.ms/PSWindows
PS C:\WINDOWS\system32> set-executionpolicy remotesigned
执行策略更改
执行策略可帮助你防止执行不信任的脚本。更改执行策略可能会产生安全风险,如 https:/go.microsoft.com/fwlink/?LinkID=135170
中的 about_Execution_Policies 帮助主题所述。是否要更改执行策略?
[Y] 是(Y) [A] 全是(A) [N] 否(N) [L] 全否(L) [S] 暂停(S) [?] 帮助 (默认值为“N”): Y
PS C:\WINDOWS\system32>
检查发现问题解决
PS C:\Users\zhangyy\PycharmProjects\djangoProject> get-executionpolicy
RemoteSigned
创建完Django项目后,在pycharm的命令行执行一下命令,可以为Django项目生成数据表,并创建一个账户和密码。密码有强密码要求,但是也可以强行不理会。
PS C:\Users\zhangyy\PycharmProjects\djangoProject> python manage.py migrate
Operations to perform:
Apply all migrations: admin, auth, contenttypes, sessions
Running migrations:
Applying contenttypes.0001_initial... OK
Applying auth.0001_initial... OK
Applying admin.0001_initial... OK
Applying admin.0002_logentry_remove_auto_add... OK
Applying admin.0003_logentry_add_action_flag_choices... OK
Applying contenttypes.0002_remove_content_type_name... OK
Applying auth.0002_alter_permission_name_max_length... OK
Applying auth.0003_alter_user_email_max_length... OK
Applying auth.0004_alter_user_username_opts... OK
Applying auth.0005_alter_user_last_login_null... OK
Applying auth.0006_require_contenttypes_0002... OK
Applying auth.0007_alter_validators_add_error_messages... OK
Applying auth.0008_alter_user_username_max_length... OK
Applying auth.0009_alter_user_last_name_max_length... OK
Applying auth.0010_alter_group_name_max_length... OK
Applying auth.0011_update_proxy_permissions... OK
Applying auth.0012_alter_user_first_name_max_length... OK
Applying sessions.0001_initial... OK
PS C:\Users\zhangyy\PycharmProjects\djangoProject> python manage.py createsuperuser
Username (leave blank to use 'zhangyy'): zhangyy
Email address:
Password:
Password (again):
The password is too similar to the username.
This password is too short. It must contain at least 8 characters.
Bypass password validation and create user anyway? [y/N]: y
Superuser created successfully.
重新启动服务器
C:\Users\zhangyy\PycharmProjects\djangoProject\venv\Scripts\python.exe C:\Users\zhangyy\PycharmProjects\djangoProject\manage.py runserver 8000
Watching for file changes with StatReloader
Performing system checks...
System check identified no issues (0 silenced).
November 06, 2022 - 20:18:36
Django version 4.1.3, using settings 'djangoProject.settings'
Starting development server at http://127.0.0.1:8000/
Quit the server with CTRL-BREAK.
在浏览器中访问“http://127.0.0.1:8000/admin/”,出现一个后台登录界面的入口。
使用刚刚创建的账户登录,可以成功登录后台管理界面,如下:
在Django项目中,推荐使用App来完成不同模块的任务,通过在“terminal”执行以下命令来启用一个应用程序
(venv) PS C:\Users\zhangyy\PycharmProjects\djangoProject> python manage.py startapp app1
可以看到App1的目录结构如下
文件目录说明:
migrations:执行数据库迁移生成的脚本
admin.py:配置Django管理后台的文件
apps.py:单独配置添加的每个App的文件
models.py:创建数据库数据模型对象的文件
tests.py:用来编写测试脚本的文件
views.py:用来编写视图控制器的文件
最后,将已经创建的App的名字添加到settings.py配置文件中,然后将其激活。
# Application definition
INSTALLED_APPS = [
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
'app1',
]
在app1的models.py中添加如下代码
from django.db import models # 引入django.db.models模块
class CreateUpdate(models.Model): # 创建抽象数据模型,同样要继承于models.Model
# 创建时间,使用models.DateTimeField
created_at = models.DateTimeField(auto_now_add=True)
# 修改时间,使用models.DateTimeField
updated_at = models.DateTimeField(auto_now=True)
class Meta: # 元数据,除了字段以外的所有属性
# 设置model为抽象类。指定该表不应该在数据库中创建
abstract = True
class Person(CreateUpdate): # 继承CreateUpdate基类
first_name = models.CharField(max_length=30)
last_name = models.CharField(max_length=30)
class Order(CreateUpdate): # 继承CreateUpdate基类
order_id = models.CharField(max_length=30, db_index=True)
order_desc = models.CharField(max_length=120)
这样,我们用于创建日期和修改日期的数据模型继承于CreateUpdate类。
C:\Users\zhangyy\PycharmProjects\djangoProject\venv\Scripts\python.exe C:\Users\zhangyy\PycharmProjects\djangoProject\manage.py runserver 8000
Performing system checks...
Watching for file changes with StatReloader
System check identified no issues (0 silenced).
November 20, 2022 - 19:58:03
Django version 4.1.3, using settings 'djangoProject.settings'
Starting development server at http://127.0.0.1:8000/
Quit the server with CTRL-BREAK.
可以总结下Django数据模型中常见的字段类型和说明
创建完数据模型后,开始做数据库迁移,首先我们不希望用Django默认的自带的SQLite数据库,我们想用MySQL数据库,在项目的settings.py配置文件中找到如下配置:
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.sqlite3',
'NAME': BASE_DIR / 'db.sqlite3',
}
}
替换为
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.mysql',
'NAME': 'demo',
'USER': 'root',
'PASSWORD': 'root'
}
}
创建数据库,在终端连接数据库,执行数据库登录命令并按照提示输入您的数据库密码,连接成功后执行如下语句创建数据库:
(venv) PS C:\Users\zhangyy\PycharmProjects\djangoProject> mysql -u root -p
Enter password: ****
Welcome to the MySQL monitor. Commands end with ; or \g.
Your MySQL connection id is 12
Server version: 8.0.31 MySQL Community Server - GPL
Copyright (c) 2000, 2022, Oracle and/or its affiliates.
Oracle is a registered trademark of Oracle Corporation and/or its
affiliates. Other names may be trademarks of their respective
owners.
Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
mysql> create database demo default character set utf8;
Query OK, 1 row affected, 1 warning (0.01 sec)
mysql>
安装数据库的驱动:
(venv) PS C:\Users\zhangyy\PycharmProjects\djangoProject> pip install pymysql
Collecting pymysql
Using cached PyMySQL-1.0.2-py3-none-any.whl (43 kB)
Installing collected packages: pymysql
Successfully installed pymysql-1.0.2
找到C:\Users\zhangyy\PycharmProjects\djangoProject\djangoProject文件,在行首添加如下代码,据说可以将pymysql发挥最大的数据库操作性能。
import pymysql
pymysql.install_as_MySQLdb()
执行以下命令,创建数据表:
(venv) PS C:\Users\zhangyy\PycharmProjects\djangoProject> python manage.py makemigrations
Migrations for 'app1':
app1\migrations\0001_initial.py
- Create model Order
- Create model Person
(venv) PS C:\Users\zhangyy\PycharmProjects\djangoProject> python manage.py migrate
Operations to perform:
Apply all migrations: admin, app1, auth, contenttypes, sessions
Running migrations:
Applying contenttypes.0001_initial... OK
Applying auth.0001_initial... OK
Applying admin.0001_initial... OK
Applying admin.0002_logentry_remove_auto_add... OK
Applying admin.0003_logentry_add_action_flag_choices... OK
Applying app1.0001_initial... OK
Applying contenttypes.0002_remove_content_type_name... OK
Applying auth.0002_alter_permission_name_max_length... OK
Applying auth.0003_alter_user_email_max_length... OK
Applying auth.0004_alter_user_username_opts... OK
Applying auth.0005_alter_user_last_login_null... OK
Applying auth.0006_require_contenttypes_0002... OK
Applying auth.0007_alter_validators_add_error_messages... OK
Applying auth.0008_alter_user_username_max_length... OK
Applying auth.0009_alter_user_last_name_max_length... OK
Applying auth.0010_alter_group_name_max_length... OK
Applying auth.0011_update_proxy_permissions... OK
Applying auth.0012_alter_user_first_name_max_length... OK
Applying sessions.0001_initial... OK
(venv) PS C:\Users\zhangyy\PycharmProjects\djangoProject>
用navicat连接到数据库,连接参数安装settings.py配置文件填写,可以从数据库查看到创建的这两张表
其中
Person类对应app1_person表
Order类对应app1_order表
而CreateUpdate是个抽象类,不会创建表结构。
导入数据模型并用两种方式创建数据:
(venv) PS C:\Users\zhangyy\PycharmProjects\djangoProject> python manage.py shell
Python 3.9.6 (tags/v3.9.6:db3ff76, Jun 28 2021, 15:26:21) [MSC v.1929 64 bit (AMD64)] on win32
Type "help", "copyright", "credits" or "license" for more information.
(InteractiveConsole)
>>> from app1.models import Person, Order
>>> p = Person.objects.create(first_name="hong", last_name="zhang")
>>> p = Person(first_name="yy",last_name="zhang")
>>> p.save()
>>>
检查数据库,数据创建成功:
查询数据和修改数据:
>>> Person.objects.get(last_name="zhang")
Traceback (most recent call last):
File "", line 1, in
File "D:\Users\zhangyy\AppData\Local\Programs\Python\Python39\lib\site-packages\django\db\models\manager.py", line 85, in manager_method
return getattr(self.get_queryset(), name)(*args, **kwargs)
File "D:\Users\zhangyy\AppData\Local\Programs\Python\Python39\lib\site-packages\django\db\models\query.py", line 653, in get
raise self.model.MultipleObjectsReturned(
app1.models.Person.MultipleObjectsReturned: get() returned more than one Person -- it returned 2!
>>> Person.objects.get(first_name="yy")
>>> Person.objects.get(first_name="hong")
>>> p = Person.objects.get(first_name="yy")
>>> p.first_name = "yyy"
>>> p.save()
也可以使用get_or_create,如果数据存在就修改,不存在就创建:
>>> p, is_created = Person.objects.get_or_create(
... first_name="yyyy",
... defaults={"last_name":"zhang"}
... )
>>>
数据库连接如下
定义好数据模型后,就可以配置管理后台了,按照如下代码编辑app1下面的admin.py文件:
from django.contrib import admin # 引入admin模块
from app1.models import Person, Order # 引入数据模型类
class PersonAdmin(admin.ModelAdmin):
"""
创建PersonAdmin类,继承于admin.ModelAdmin
"""
# 配置展示列表,在Person板块下的列表展示
list_display = ('first_name', 'last_name')
# 配置过滤查询字段,在Person板块下右侧过滤框
list_filter = ('first_name', 'last_name')
# 配置可以搜索的字段,在Person板块下右侧搜索框
search_fields = ('first_name',)
# 配置只读字段展示,设置后该字段不可编辑
readonly_fields = ('created_at', 'updated_at')
# 绑定Person模型到PersonAdmin管理后台
admin.site.register(Person, PersonAdmin)
点击“run”,在浏览器中访问“http://127.0.0.1:8000/admin/”,效果如图:
Django 的URL路由流程:
(1) Django查找全局urlpatterns变量(urls.py)
(2) 按照先后顺序,对URL逐一匹配urlpatterns每个元素。
(3) 找到第一个匹配时停止查找,根据匹配结果执行对应的处理函数。
(4) 如果没有找到匹配或者出现异常,Django进行错误处理。
Django 支持三种表达形式,分别是:
(1)精确地字符串格式:articles/2022/。
(2)Django 的转换格式: <类型:变量名>,articles/
(3)正则表达式格式,如“articles/(?p
编写URL的三种情况:
1.普通URL
2.顺序传参
3.关键字传参。
推荐使用关键字传参。打开项目根目录的配置文件夹下面的urls.py文件,打开文件,添加一行代码如下:
"""djangoProject URL Configuration
The `urlpatterns` list routes URLs to views. For more information please see:
https://docs.djangoproject.com/en/4.1/topics/http/urls/
Examples:
Function views
1. Add an import: from my_app import views
2. Add a URL to urlpatterns: path('', views.home, name='home')
Class-based views
1. Add an import: from other_app.views import Home
2. Add a URL to urlpatterns: path('', Home.as_view(), name='home')
Including another URLconf
1. Import the include() function: from django.urls import include, path
2. Add a URL to urlpatterns: path('blog/', include('blog.urls'))
"""
from django.contrib import admin
from django.urls import path, include
urlpatterns = [
path('admin/', admin.site.urls),
path('app1/', include('app1.urls')) #添加
]
然后在app1下面创建一个urls.py文件,并在其中编写属于这个模块的url规则:
下面用三种方式创建路由。
app1的urls.py文件:
from app1 import views as app1_views
from django.urls import path
urlpatterns = [
# 精确匹配视图
path('articles/2022/', app1_views.articles),
]
其中app1_views是views的别名。
在app1的views.py添加代码:
from django.shortcuts import render
from django.http import HttpResponse, HttpResponseRedirect
def articles(request):
return HttpResponse("hello world")
测试
app1的urls.py文件:
from app1 import views as app1_views
from django.urls import path
urlpatterns = [
# 匹配一个整数
path('article/', app1_views.articles),
]
在app1的views.py修改代码:
from django.shortcuts import render
from django.http import HttpResponse, HttpResponseRedirect
def articles(request, year):
content = 'the year is %s' % year
return HttpResponse(content)
测试
app1的urls.py文件:
from django.urls import re_path
from app1 import views as views
from django.urls import path
urlpatterns = [
# 按照正则表达式匹配4位数字年份
re_path(r'^article/(?P[0-9]{4})/$', views.article),
]
在app1的views.py代码保持不变
测试
若修改app1的urls.py文件为:
from django.urls import re_path
from app1 import views as views
from django.urls import path
urlpatterns = [
# 按照正则表达式匹配4位数字年份和2位数字月份
re_path(r'^articles/(?P[0-9]{4})/(?P[0-9]{2})/$', views.month_articles),
views.article_detail),
]
在app1的views.py修改代码:
from django.shortcuts import render
from django.http import HttpResponse, HttpResponseRedirect
def month_articles(request, year, month):
content = 'the year is %s , the month is %s' % (year, month)
return HttpResponse(content)
测试
在app1文件夹下创建一个forms.py文件,添加如下类代码:
from django import forms
class PersonForm(forms.Form):
first_name = forms.CharField(label='你的名字', max_length=20)
last_name = forms.CharField(label='你的姓氏', max_length=20)
上面定义了一个PersonForm表单类,两个字段类型为forms.CharField,first_name指字段的label为你的名字,并且指定该字段的最大长度为20字符。max_length可以指定forms.CharField的验证长度。
表单类forms.Form有一个is_valid()方法,可以在views.py中验证提交的表单是否符合规则。对于提交的内容,在views.py下编写 如下代码:
from django.shortcuts import render
from django.http import HttpResponse, HttpResponseRedirect
from app1.forms import PersonForm
def get_name(request):
# 判断请求方法是否为POST
if request.method == 'POST':
# 将请求数据填充到PersonForm实例中
form = PersonForm(request.POST)
# 判断form是否为有效表单
if form.is_valid():
# 使用form.cleaned_data获取请求的数据
first_name = form.cleaned_data['first_name']
last_name = form.cleaned_data['last_name']
# 响应拼接后的字符串
return HttpResponse(first_name + '' + last_name)
else:
return HttpResponseRedirect('/error/')
# 请求为GET方法
else:
return render(request, 'name.html', {'form': PersonForm()})
这里有一个html文件的名字。我们要创建这个html文件。
在app1的同级目录下有个templates目录,在这个目录里新建name.html文件。
编写name.html文件
Title
还需要到app1目录下的urls.py的
urlpatterns = []里面
添加一行
path('get_name', views.get_name),
OK, 接下来测试。
打开
http://127.0.0.1:8000/app1/get_name
可以看到
填写名字,点击提交,效果如图
这里显示“yyzhang”就是执行了views.py里的这行代码
return HttpResponse(first_name + '' + last_name)
django.http模块下有诸多继承于HttpResponse的对象,其中大部分在开发中都可以利用到。例如我们想在查询不到数据时,给客户端返回一个Http 404 的错误页面。可以利用django.http下面的Http404对象,在views.py里编写代码如下:
from django.shortcuts import render
from django.http import HttpResponse, HttpResponseRedirect, Http404
from app1.forms import PersonForm
from app1.models import Person
def person_detail(request, pk): # url参数pk
try:
p = Person.objects.get(pk=pk) # 获取Person数据
except Person.DoesNotExist:
raise Http404('Person Does Not Exist') # 获取不到抛出Http404错误页面
return render(request, 'person_detail.html', {'person': p}) # 返回详细信息视图
新建一个与name.html文件同级的person_detail.html文件
编写如下html代码
Title
{{ person.first_name }}
不要忘了到app1目录下的urls.py的urlpatterns = []里面 添加一行path:
path('person_detail/', views.person_detail)
测试结果1:
测试结果2
测试结果3:
对照5.3章节的数据库表截图,可知,测试正确
基于类的视图和基于函数的视图大同小异。首先定义一个类视图,这个类视图需要继承一个基础的类视图,所有的类视图都继承自views.View。类视图的初始化参数需要给出。将上一章节定义的get_name()方法改成基于类的视图,修改views.py代码如下:
from django.shortcuts import render
from django.http import HttpResponse, HttpResponseRedirect, Http404
from django.views import View
from app1.forms import PersonForm
from app1.models import Person
class PersonFormView(View):
form_class = PersonForm # 定义表单类
initial = {'key': 'value'} # 定义表单初始化展示参数
template_name = 'name.html' # 定义渲染的模板
def get(self, request, *args, **kwargs): # 定义GET请求的方法
# 渲染表单
return render(request, self.template_name,
{'form': self.form_class(initial=self.initial)})
def post(self, request, *args, **kwargs): # 定义POST请求的方法
form = self.form_class(request.POST) # 填充表单实例
if form.is_valid(): # 判断请求是否有效
# 使用form.cleaned_data获取请求的数据
first_name = form.cleaned_data['first_name']
last_name = form.cleaned_data['last_name']
# 响应拼接后的字符串
return HttpResponse(first_name + '' + last_name) # 返回拼接的字符串
return render(request, self.template_name, {'form': form}) # 如果表单无效,返回表单
到app1目录下的urls.py的urlpatterns = []里面 添加一行path:
path('get_name1', views.PersonFormView.as_view()),
测试
填写名字,点击提交,效果如图
OK, 基于类的视图也测试成功!
模板语言包括四个内容
下面都是从views.py中修改演示模板
变量 在之间的例子里已经用过了。
标签 的使用
Title
{{ person.first_name }}
{% if person.first_name == 'hong'%}
hi, hong
{% else %}
hi, 陌生人
{% endif %}
测试
过滤器的使用
Title
{{ person.first_name }}
{{ person.first_name|upper }}
{% if person.first_name == 'hong'%}
hi, hong
{% else %}
hi, 陌生人
{% endif %}
测试
注释的使用
Title
{{ person.first_name }}
{{ person.first_name|upper }}
{% if person.first_name == 'hong'%}
hi, hong
{% else %}
hi, 陌生人
{% endif %}
测试结果
如果你只是想 将上面HTML里的“陌生人”注释掉,可以将“陌生人”修改为 “{# 陌生人#}”。
通过这篇博客的学习,不难发现,Django视图编写灵活、URL优雅,有适用于快速开发的模板以及强大的管理后台,这些使得它在python web开发领域占据了不可动摇的地位。