Django基本配置

Posted maplethefox

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Django基本配置相关的知识,希望对你有一定的参考价值。

一settings.py 文件配置

1. BASE_DIR

  用于绑定当前项目的绝对路径 ( 动态计算出来的 ), 所有文件都可以依懒此路径

2. DEBUG

  用于配置 Django 项目的启用模式 , 取值 :

  1. True 表示开发环境中使用 调试模式 ( 用于开发中 )

  2. False 表示当前项目运行在生产环境中 ( 不启用调试 )

3.ALLOWED_HOSTS

  设置允许访问到本项目的网络地址列表 , 取值 :

  1. [] 空列表 , 表示只有 127.0.0.1, localhost, ‘[::1]‘ 能访问本项目
  2. [‘*‘] ,表示任何网络地址都能访问到当前项目\\
  3. [‘*.tedu.cn‘, ‘weimingze.com‘] 表示只有当前两个主机能访问当前项目

  注意 :

  如果要在局域网其它主机也能访问此主机 , 启动方式应使用如下模式 :python3 manage.py runserver 0.0.0.0:5000 # 指定网络设备所有主机都可以通过 5000 端口访问 ( 需加 ALLOWED_HOSTS = [‘*‘])

4.INSTALLED_APPS

  指定当前项目中安装的应用列表

5. MIDDLEWARE

  用于注册中间件

6. TEMPLATES

  用于指定模板的配置信息

7. DATABASES

  用于指定数据库的配置信息

  支持SQLite 3(默认)、PostgreSQL 、mysql、Oracle数据库的操作

技术图片
# 默认是SQLit 3 的配置

DATABASES = 
    default: 
        ENGINE: django.db.backends.sqlite3,
        NAME: os.path.join(BASE_DIR, db.sqlite3),
    



# MySQL的配置

DATABASES = 
    default: 
    ENGINE: django.db.backends.mysql,
    NAME:dbname,   #注意这里的数据库应该以utf-8编码
    USER: xxx,
    PASSWORD: xxx,
    HOST: ‘‘,
    PORT: ‘‘,
    


# 对于python3的使用者们还需要再加一步操作
# 由于Django内部连接MySQL时使用的是MySQLdb模块,而python3中还无此模块,所以需要使用pymysql来代替
  
# 如下设置放置的与project同名的配置的 __init__.py文件中
  
import pymysql
pymysql.install_as_MySQLdb()


# PostgreSQL配置
DATABASES = 
    default: 
        NAME: app_data,
        ENGINE: django.db.backends.postgresql_psycopg2,
        USER: XXX,
        PASSWORD: XXX
    


# Oracle配置
DATABASES = 
    default: 
        ENGINE: django.db.backends.oracle,
        NAME: xe,
        USER: a_user,
        PASSWORD: a_password,
        HOST: ‘‘,
        PORT: ‘‘,
    
数据库配置文件

8. LANGUAGE_CODE

  用于指定语言配置

  取值 :

    • 英文 : "en-us"
    • 中文 : "zh-Hans"

9. TIME_ZONE

  用于指定当前服务器端时区

  取值 :

    • 世界标准时间 : "UTC"
    • 中国时区 : "Asia/Shanghai"

10. ROOT_URLCONF

  用于配置根级 url 配置 ‘mywebsite1.urls‘

  如 :ROOT_URLCONF = ‘mywebsite1.urls‘

11. 静态文件添加

# 首先在项目根目录下创建static目录
# 接着在settings.py 文件下添加
# 配置访问路径
STATIC_URL = /static/  # 默认已添加,使用静态文件时的前缀
# 配置存储路径
STATICFILES_DIRS = (
        os.path.join(BASE_DIR,static), #行末的逗号不能漏
    )
# 这样在template中就可以导入static目录下的静态文件啦
# 例:
<script src="/static/jquery-1.12.4.js"></script>

二urls.py路由系统文件配置

URL配置(URLconf)就像Django 所支撑网站的目录。它的本质是URL模式以及要为该URL模式调用的视图函数之间的映射表;你就是以这种方式告诉Django,对于这个URL调用这段代码,对于那个URL调用那段代码。URL的加载是从配置文件中开始。

url 即统一资源定位符 Uniform Resource Locator

作用 :用来表示互联网上某个资源的地址。

说明 :互联网上的每个文件都有一个唯一的 URL ,它包含的信息指出文件的位置以及浏览器应该怎么处理它。

URL的一般语法格式为:

protocol :// hostname[:port] / path [?query][#fragment]
(带方括号[ ] 的为可选项) :

说明 :

1.protocol(协议)

  • http 通过 HTTP 访问该资源。 格式 HTTP://
  • https 通过安全的 HTTPS 访问该资源。 格式 HTTPS://
  • file 资源是本地计算机上的文件。格式 : file:///

2.hostname(主机名)

  是指存放资源的服务器的域名系统 (DNS) 主机名、域名 或 IP 地址。

3.port(端口号)

  • 整数,可选,省略时使用方案的默认端口;
  • 各种传输协议都有默认的端口号,如 http 的默认端口为 80 。

4.path(路径)

  由零或多个 “/” 符号隔开的字符串,一般用来表示主机上的一个目录或文件地址。

5.query(查询)

  可选,用于给动态网页传递参数,可有多个参数,用 “&” 符号隔开,每个参数的名和值

  用 “=” 符号隔开。

6.fragment(信息片段)

  字符串,用于指定网络资源中的片断。

  例如:一个网页中有多个名词解释,可使用 fragment 直接定位到某一名词解释。

路由地址

  • url地址中不看域名部分即为路由地址
  • 如 :http://www.tedu.com:8000/article/python.html的路由地址是 /article/python.html
  • 路由地址决定了服务器端如何处理这个请求

Django 中的 URL 路由配置

1. settings.py 中的 ROOT_URLCONF

ROOT_URLCONF = mywebsite1.urls

  通过 ROOT_URLCONF 指定顶级 url 的配置

  默认存在于主文件夹内 urls.py 主路由配置文件

2.urls.py 主路由配置文件

# file : <项目名>/urls.py
urlpatterns = [
    url(r^admin/, admin.site.urls),
    ...
]

  说明:urlpatterns是一个 url() 实例的列表 .

  作用:该文件会包含 urlpatterns 的列表用于表示路由 - 视图映射 , 通过 url() 表示具体映射

 3.url()函数

用于描述路由与视图函数的对应关系

模块:from django.conf.urls import url

语法 :url(regex, views, kwargs=None, name=None)

  • regex:字符串类型,匹配的请求路径,允许是正则表达式
  • views: 指定路径所对应的视图处理函数的名称
  • kwargs: 向视图中传递的参数,如果没有参数可以省略
  • name: 为地址起别名,在模板中地址反向解析时使用

注:

每个正则表达式前面的 r 表示 ‘\\‘ 不转义的原始字符串

当 urlpatterns 内有多个 url 对象时,按自上而下的顺序进行配置,一但有路由与 url 匹配成功,则后面的所有 url 被忽略.

4.二级路由(lncluding)

如果映射 url 太多怎么办,全写一个在  urlpatterns 显得繁琐,so 二级路由应用而生.

使用二级路由也可以减少代码冗余,使代码更加简洁易懂.

# 原始版本
from django.conf.urls import url
from . import views
 
urlpatterns = [
    url(r^(?P<page_slug>[\\w-]+)-(?P<page_id>\\w+)/history/$, views.history),
    url(r^(?P<page_slug>[\\w-]+)-(?P<page_id>\\w+)/edit/$, views.edit),
    url(r^(?P<page_slug>[\\w-]+)-(?P<page_id>\\w+)/discuss/$, views.discuss),
    url(r^(?P<page_slug>[\\w-]+)-(?P<page_id>\\w+)/permissions/$, views.permissions),
]
 
 
# 改进版本
from django.conf.urls import include, url
from . import views
 
urlpatterns = [
    url(r^(?P<page_slug>[\\w-]+)-(?P<page_id>\\w+)/, include([
        url(r^history/$, views.history),
        url(r^edit/$, views.edit),
        url(r^discuss/$, views.discuss),
        url(r^permissions/$, views.permissions),
    ])),
]

5.添加额外的参数

URLconfs 有一个钩子可以让你加入一些额外的参数到view函数中.

from django.conf.urls import url
from . import views
   
urlpatterns = [
    url(r^blog/(?P<year>[0-9]4)/$, views.year_archive, foo: bar),
]

#####################

def year_archive(request, foo):
    print(foo)
    return render(request, index.html)

在上面的例子中,如果一个请求为 /blog/2005/, Django 将会调用函数

views.year_archive(request, year=‘2005‘,foo=‘bar‘).

需要注意的是,当你加上参数时,对应函数views.year_archive必须加上一个参数,参数名也必须命名为 foo.

6.别名的使用

url(r‘^index‘,views.index,name=‘bieming‘)

url中还支持name参数的配置,如果配置了name属性,在模板的文件中就可以使用name值来代替相应的url值.

技术图片
urlpatterns = [
    url(r^index,views.index,name=bieming),
    url(r^admin/, admin.site.urls),
    # url(r‘^articles/2003/$‘, views.special_case_2003),
    url(r^articles/([0-9]4)/$, views.year_archive),
    # url(r‘^articles/([0-9]4)/([0-9]2)/$‘, views.month_archive),
    # url(r‘^articles/([0-9]4)/([0-9]2)/([0-9]+)/$‘, views.article_detail),

]
###################

def index(req):
    if req.method==POST:
        username=req.POST.get(username)
        password=req.POST.get(password)
        if username==alex and password==123:
            return HttpResponse("登陆成功")



    return render(req,index.html)

#####################

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
#     <form action="/index/" method="post">#
#     这里只要使用bieming即可代替/index #
     <form action="% url ‘bieming‘ %" method="post">
         用户名:<input type="text" name="username">
         密码:<input type="password" name="password">
         <input type="submit" value="submit">
     </form>
</body>
</html>
示例演示

三视图view

用于接收请求 , 处理请求并做出响应

视图处理的函数的语法格式

def xxx(request[,其他参数...]):
    return 响应对象(HttpResponse对象)

示例:

技术图片
# file : <项目名>/urls.py
urlpatterns = [
    url(r^admin/, admin.site.urls),
    url(r^/, views.index_view),
    url(r^page1$, views.page1_view),
    url(r^page2$, views.page2_view),
]
路由配置文件urls.py
技术图片
# file : <项目名>/views.py
from . import views
from django.http import HttpResponse

def index_view(request):
    return HttpResponse("这是首页")
def page1_view(request):
    return HttpResponse("这是第1个页面")
def page2_view(request):
    return HttpResponse("这是第2个页面")
视图处理函数views,py

练习:?建立一个小网站:

  • 输入网址: http://127.0.0.1:8000, 在网页中输出 : 这是我的首页
  • 输入网址: http://127.0.0.1:8000/page1, 在网页中输出 : 这是编号为1的网页
  • 输入网址: http://127.0.0.1:8000/page2, 在网页中输出 : 这是编号为2的网页

(一)url 正则表达式命名分组 和 带有参数的视图函数

1.带有分组的路由和视图函数

在视图函数内,可以用正则表达式分组 () 提取参数后用函数位置传参传递给视图函数

一个分组表示一个参数,多个参数需要使用多个分组,并且使用个 / 隔开

如:

  • http://127.0.0.1:8000/year/2018
  • http://127.0.0.1:8000/year/2019
  • http://127.0.0.1:8000/year/???? # 四位数字

分组:

示例

技术图片
# file : <项目名>/urls.py
urlpatterns = [
    url(r^admin/, admin.site.urls),
    url(r^year/(\\d4)$, views.year_view),
    url(r^date/(\\d4)/(\\d+)/(\\d+)$, views.date_view),
]
路由配置文件
技术图片
# file : <项目名>/views.py
from django.http import HttpResponse

def year_view(request, year):
    return HttpResponse("年:" + year)  # 注: year绑定字符串 ‘2019‘
def date_view(request, year, month, day):
    return HttpResponse(year + "" + month + "" + day + "")  # 注: year绑定字符串 ‘2019‘
视图处理文件

练习:?定义一个路由的格式为:

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

2.带有命名分组 (?P<name>xxx) 的路由和视图函数

  • 在url 的正则表达式中可以使用命名分组(捕获分组)
  • 正表达式分名的名称必须在view中以关键字传参方式传入,因此视图函数必须能接收此参数
  • 每个捕获的参数都作为一个普通的python字符串传递给视图(不会做类型转换)
  • urlpatterns中的每个正则表达式在第一次访问它们时被编译,这使得系统相当快

示例:

技术图片
# 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>\\d1,2),views.person_view),
]
路由配置文件
技术图片
# file : <项目名>/views.py
from . import views
from django.http import HttpResponse

def person_view(request, name, age):
    return HttpResponse("姓名:" + name + " 年龄:" + age)
视图文件

练习:

  • 访问地址: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日

(二)http请求中产生两个核心对象:

http请求:HttpRequest对象    指浏览器端通过HTTP协议发送给服务器端的数据

http响应:HttpResponse对象 指服务器端接收到请求后做相应的处理后再回复给浏览器端的数据

1.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 回显服务器收到的请求,主要用于测试或诊断.

2.HttpRequest对象

当请求一个页面时,Django 创建一个 HttpRequest对象包含原数据的请求。然后 Django 加载适当的视图,通过 HttpRequest作为视图函数的第一个参数。每个视图负责返回一个HttpResponse目标。

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地址
  • request.META[‘HTTP_REFERER‘] : 请求源地址
技术图片
# file : urls.py
from django.conf.urls import url
from django.contrib import admin

from . import views

urlpatterns = [
    url(r^admin/, admin.site.urls),
    url(r^show_info, views.show_info),
]
路由配置文件
技术图片
# file : views.py
from django.http import HttpResponse

def show_info(request):
    html = <div> + "请求方式: " + request.method + </div>
    html += <div> + "request.GET: " + str(dict(request.GET)) + </div>
    html += <div> + "request.POST: " + str(dict(request.POST)) + </div>
    html += <div> + "request.COOKIES: " + str(request.COOKIES) + </div>
    html += <div> + "客户端浏览器协议是:request.scheme: " + request.scheme + </div>
    html += <div> + "客户端的IP地址是:request.META[‘REMOTE_ADDR‘]: " + str(request.META[REMOTE_ADDR]) + </div>
    # html += ‘<div>‘ + "request.META:" + str(request.META) + ‘</div>‘

    return HttpResponse(html)
视图处理文件

3.HTTP响应

当浏览者访问一个网页时,浏览者的浏览器会向网页所在服务器发出请求。当浏览器接收并显示网页前,此网页所在的服务器会返回一个包含HTTP状态码的信息头用以响应浏览器的请求。

HTTP状态码的英文为HTTP Status Code。

下面是常见的HTTP状态码:

  • 200 - 请求成功
  • 301 - 资源(网页等)被永久转移到其它URL
  • 404 - 请求的资源(网页等)不存在
  • 500 - 内部服务器错误

HTTP状态码分类:

HTTP状态码由三个十进制数字组成,第一个十进制数字定义了状态码的类型,后两个数字没有分类的作用。HTTP状态码共分为5种类型:

分类 分类描述
1** 信息,服务器收到请求,需要请求者继续执行操作
2** 成功,操作被成功接收并处理
3** 重定向,需要进一步的操作以完成请求
4** 客户端错误.请求包含语法错误或无法完成请求
5** 服务器错误,服务器在处理请求的过程中发生了错误

 4.HttpRespanse对象

对于HttpRequest对象来说,是由django自动创建的,但是,HttpResponse对象就必须我们自己创建。每个view请求处理方法必须返回一个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)是指多用途互联网邮件扩展类型。

 其它HttpResponse响应对象

类型 作用 状态码
HttpResponseRedirect 重定向 301
HttpResponseNotModified 未修改 304
HttpResponseBadRequest 错误请求 400
HttpResponseNotFound 没有对应的资源 404
HttpResponseForbidden 请求被禁止 403
HttpResponseServerError 服务器错误 500

5. render()

在HttpResponse对象上扩展的常用方法:

  • 页面渲染:render(推荐),render_to_response,
  • 页面跳转:redirect
  • locals:   可以直接将对应视图函数中所有的变量传给模板   

技术图片

值得注意的是对于页面渲染的方法中,render和render_to_response使用方法和功能类似,但是render功能更为强大,推荐使用

render(request, template_name, context=None, content_type=None, status=None, using=None)[source]

结合给定的模板与一个给定的上下文,返回一个字典HttpResponse在渲染文本对象

所需的参数

 template_name 一个模板的使用或模板序列名称全称。如果序列是给定的,存在于第一个模板将被使用。

可选参数

context    一组字典的值添加到模板中。默认情况下,这是一个空的字典。

content_type    MIME类型用于生成文档。

status    为响应状态代码。默认值为200

using    这个名字一个模板引擎的使用将模板。

from django.shortcuts import render

def my_view(request):
    # View code here...
    return render(request, myapp/index.html, 
        foo: bar,
    , content_type=application/xhtml+xml)

 

6.GET方式传参

  GET请求方式中可以通过查询(Query) 将数据传递给服务器

GET方式查询参数获取(查询字符串 Query String)

客户端传递参数给服务器端

  URL格式:网址?参数名1=值1&参数名1=值2

服务器端接收参数

  1.判断resquest.method的值判断请求方式是否是get请求

if request.method == GET:
    去往指定的模板进行显示
else:
    接收其它请求提交的数据

  2.获取客户端请求GET请求提交的数据

    (1)语法:

      • request.GET[‘参数名‘]
      • request.GET.get(‘参数名‘,‘默认值‘)
      • request.GET.getlist(‘参数名‘)

    (2)能够产生get请求方式的场合    

      • 地址栏手动输入, 如: http://www.sina.com.cn/?a=100&b=200
      • <a href="地址?参数=值&参数=值">
      • 表单中的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
    • 页面显示: 结果: 2500
    • 输入网址: http://127.0.0.1:8000/sum?start=1&stop=101&step=2
    • 页面显示: 结果: 2550

7.POST传递参数的获取

  客户端通过表单等POST请求将数据传递给服务器端,如:

<form method=post action="/user/login">
    姓名:<input type="text" name="username">
</form>

  服务器端接收参数:通过 request.method 来判断是否为POST请求,如:

if request.method == POST:
    处理 POST 请求的数据并响应
else:
    处理非 POST 请求的响应

   使用post方式接收客户端数据

    语法

    • request.POST[‘参数名‘]
    • request.POST.get(‘参数名‘,‘‘)
    • request.POST.getlist(‘参数名‘)

  取消csrf验证,否则Django将会拒绝客户端发来的POST请求

    取消 csrf 验证

      删除 settings.py 中 MIDDLEWARE 中的 CsrfViewsMiddleWare 的中间件

MIDDLEWARE = [
    ...
    # ‘django.middleware.csrf.CsrfViewMiddleware‘,
    ...
]

 

以上是关于Django基本配置的主要内容,如果未能解决你的问题,请参考以下文章

Django配置管理settings文件配置

Python3.8安装配置Django环境(上)

Django的一些基本配置

django基本操作

Django---MTV模型基本命令简单配置

Django_基本配置保存