最全的Django入门及常用配置

2022-11-02 16:32:30

Django 常用配置

Django 安装

　　　　pipx install django
    • x 为python解释器版本2 or 3
    • 如果你想安装指定版本的django，使用pip install django=1.11.8

python manage.py 不加任何其他参数时，返回命令列表，类似help

项目

创建一个Django项目

  • 终端输入 
    django-admin startproject 项目名称
 
# 初始文件结构

mysite

    |

    |--mysite

    |        |

    |        |--__init__.py

    |        |--settings.py

    |        |--urls.py

    |        |--wsgi.py

    |

    |

    |

    |--manage.py

manage.py

  1. 可以看作Django项目的工具，通过它来调用Django shell和数据库

    • 比如"操作数据库(在数据库中生成表)"，"启动项目"，"创建应用"等

  2. 启动文件，寻找其他模块的路径开始位置

    • 通过manage.py启动之后，python解释器将其所在路径添加进模块与包的搜索路径(sys.modules)。
    • 此时，在其他文件中导入项目下的模块如下
      • 在app中的views.py导入mysite下的urls
      • from mysite import urls
      • 在manage.py中导入mysite下的urls
      • from mysite import urls

settings.py

  • 项目的默认配置。
    • 数据库信息
    • 时区
    • 调式模式
    • 安装的应用
    • 各种路径
      • HTML模板文件夹路径
      • 静态文件路径

urls.py

  • 简单来说，urls.py的作用其实就是实现了url路径与视图函数的映射关系
  • 路由，将请求对象request中封装的的url地址映射到具体的视图处理函数或者下一个路由（url分发）

应用

一个项目下可以有多个应用，比如微信有聊天应用、朋友圈应用等

  • 进入mysite项目文件夹下 
    python manage.py startapp 应用名
# 此时文件夹结构
mysite/

    |

    |--mysite/

    |        |

    |        |--__init__.py

    |        |--settings.py

    |        |--urls.py

    |        |--wsgi.py

    |

    |--app/

    |    |--    migrations/

    |    |            |-- __init__.py

    |    |--admin.py

    |    |--apps.py

    |    |--models.py

    |    |--tests.py

    |    |--views.py

    |

    |-- templates/

    |

    |

    |

    |--manage.py

启动Django项目

  • pythonx manage.py runserver IP:PORT
    • x 是python版本
    • PORT默认8000
    • IP为0.0.0.0的时候，服务器会监听机器上所有IP端口，这意味这我们在其他电脑上通过服务器IP以及对应端口就可以访问服务器url对应的资源

配置时区

  • Web项目中，不可避免的要使用的到时间，通常Django默认的配置是UTC时间，因此我们需要手动的将配置文件中的时区配置修改一下下。
　　方法一: 修改"TIME_ZONE"
    • 配置TIME_ZONE = 'Asia/Shanghai'（配置时要注意时区的大小写昂，做项目要把细节掌控到位，否则后期BUG有你受的）
　　方法二: 修改"USE_TZ"
    • 如果觉得上面拼写容易出错，可以使用这个方法
    • 直接设置配置USE_TZ = False即可

为URL配置APPEND_SLASH参数

  • Django会默认给URL路径末尾添加一个/再去urls.py中去匹配，如果我们url指向的是一个文件，比如http://127.0.0.1:8080/index.html，默认情况下，Dajngo会帮我们处理成http://127.0.0.1:8080/index.html\这显然是不合理的。
  • 设置APPEND_SLASH=False就可以避免Django自动为url添加斜线。这同时也意味着我们在urls.py中配置路径映射的时候，一定要有一个规范，这样才能在开发中避开容易掉进的坑。
  • 现在给自己的url.py映射中路径定义一个规范
    1. 路径必须以^开始，以$结束
      • 不加结束符时，r'^/jesi/'可以匹配r'ziawang/xxxxxxxxxx/asdasd'
    2. 路径指向文件时，不在结尾添加/
      • r'^jesi/index.html$'
    3. 路径不指向文件时，应在路径末尾添加/
      • r'^jesi/index/$'
    4. 所有HTML、视图函数及其他文件中，路径必须和urls.py中定义的路径一样，有/的必须加上/，否则会找不到网页

引入静态文件

在应用下直接创建static目录

  • 当启动一个Django项目时，程序会在项目的模块搜索路径下搜索(应用所在目录以及应用的下一级目录)名称为static的目录，并将检索的目录作为以后检索静态文件的检索路径。     因此，在我们开发一个应用组件的时候，要保证组件的普遍适用性，我们要尽量将组件会使用到的静态文件保存在组件应用目录下的"static目录下，采用这种方式我们不需要修改"settings.py"配置文件的任何配置"
    • templates目录和static检索的原理相同，我们也可以直接在应用目录下创建一个templates目录用来存放应用专属的模板文件，不需要修改配置文件的任何配置

配置STATICFILES_DIRS

static只用来存放服务端使用到的静态文件，对于用户上传的文件（头像等）应该使用media，在Web开发中，用户上传的文件应该存放在服务器上

  • 配置文件内容如下
STATIC_URL='/static/'

STATICFILES_DIRS = [

    # static为项目路径下你存放静态文件的文件夹的实际路径

    os.path.join(BASE_DIR, 'static', 'css')

]

  • os.path.join(BASEDIR, 'static', 'css')是静态文件存放的实际路径，STATIC_URL='/static/'中的/static/是这个路径的别名。两者是一个映射关系，如果要使用该静态文件，   那么静态文件的URL中的"实际路径部分"就要使用别名来代替比如，要引入css文件.

    • <link rel="stylesheet" href="/static/teststatic.css">
      • href中的/static/映射的实际路径是/static/css/teststatic.css
    • 如果使用<link rel="stylesheet" href="/static/css/teststatic.css">服务端就会响应一个404错误

  • 配置好static之后，开启服务器，我们直接在浏览器栏中输入静态文件的路径就可以访问静态文件。这是因为配置完static之后，django会将static对应路径下的静态文件配置到路由中，而不需要我们手动添加，保证在其他HTML文件中可以正常引用静态文件

127.0.0.1:8000/static/teststatic.css

使用 {% load staticfiles %}

  • 在前端模板页面中我们可以使用{% load staticfiles %}的方式来引入static中的静态文件
  • css/js文件中，应该这样写 
    • <link rel="stylesheet" href="{% static '/css/room_table.css' %}">
　　　　　　{% load staticfiles %}

　　　　　　<!DOCTYPE html>

　　　　　　<html lang="en">

　　　　　　<head>

    　　　　　　<meta charset="UTF-8">

    　　　　　　<title>Title</title>

    　　　　　　<link rel="stylesheet" href="https://cdn.bootcss.com/bootstrap/3.3.7/css/bootstrap.min.css">

    　　　　　　<link rel="stylesheet" href="https://cdn.bootcss.com/font-awesome/4.7.0/css/font-awesome.min.css">

    　　　　　　<link rel="stylesheet" href="{% static 'css/room_table.css' %}">

　　　　　　</head>

关于static目录

  • 在开发组件的过程中，由于组件需要满足大多数场景下的使用，这个时候，组件中使用到的静态文件就不能放在项目的根目录下，而是应该放在组件应用路径下
  • 注意
    • 1. 组件静态文件的配置不能修改Django项目的settings.py中static的配置，因为那样会降低组件的普遍适用性，否则使用该组件的用户会常常疲于配置组件的静态文件配置
    • 2. 组件静态文件要创建在组件应用的目录下，这样可以增加可移植性

配置应用

添加

  • 在INSTALLED_APPS中将应用的名称添加上，这种方式在旧版本上比较常见，因为旧版本中没有apps.py文件
　　INSTALLED_APPS = [

    　　'django.contrib.admin',

   　　 'django.contrib.auth',

    　　'django.contrib.contenttypes',

   　　 'django.contrib.sessions',

    　　'django.contrib.messages',

    　　'django.contrib.staticfiles',

    　　'myapp',

　　]
  • 在INSTALLED_APPS中将应用下apps.py文件中的AppConfig类传入
    • apps.py文件源码如下
　　from django.apps import AppConfig

　　class AppConfig(AppConfig):

   　　 name = 'rbac'                # 应用名
　　INSTALLED_APPS = [

  　　  'django.contrib.admin',

   　　 'django.contrib.auth',

   　　 'django.contrib.contenttypes',

   　　 'django.contrib.sessions',

    　　'django.contrib.messages',

    　　'django.contrib.staticfiles',

    　　'rbac.apps.AppConfig',

　　]

查看Django全局配置

  • Django的全局配置存放在django.conf下的global_settings文件中，要想查看该配置文件中的内容，可以先导入该文件，在pycharm中使用ctrl + 鼠标左键点击即可
　　from django.conf import global_settings

后台运行Django

  • 在公司一般都是使用Nginx反向解析配合uwsgi来搭建服务端运行环境。

    • uwsgi直接运行Django程序不会加载静态文件，不过Nginx反向代理uwsgi监控接口可以实现动静分离，实现对静态文件的支持

  • 当然，如果你有自己的服务器比如vps，就可以自己搭建上述环境，如果你觉的麻烦，并且仅仅是为了测试，你可以这样

    • nohup python3 manage.py runserver 0.0.0.0:80 &

WSGI协议

　　在了解WSGI协议之前我们有必要区分一下Web服务器与Web应用程序

　　Web服务器

    • 　　Web服务器用来处理客户端请求，并且将请求转发给Web应用，严格上来讲，Web服务器只能用来处理HTTP请求和响应信息，并且只能向用户发送静态页面的内容，对于动态页面的内容，幼通过CGI、FastCGI等接口交给Web程序去处理
    • 　　常见的Web服务器报货Nginx、Apache等

　　Web应用程序

    • 　　Web应用程序一般也支持HTTP协议，用来处理业务逻辑，比如我们的python开发中常用的Django、Flask框架

　　为什么要有WSGI协议

    • 　　对于每一个Web应用程序来说，都需要有一个Web服务器与其进行通信，如果Web应用程序与Web服务器之间的协议（你可以理解为沟通的语言）是不同的，那么Web服务器与Web应用程序之间就无法沟通，导致无法处理客户端的请求。                                 一次你，就像HTTP协议一样，python定义了一个python的Web服务器与Web框架之间沟通的通用协议，这就是WSGI。有了WSGI，Web框架就可以与任意一个实现了WSGI协议的Web服务器进行联系并处理客户端请求了。

　　使用uwsgi替代Django、Flask自带服务器

    • 　　为了开发方便，Django和Flask都内置了Web服务器，在正式生产环境中，我们要用其他Web服务器替换内置的服务器。
上一篇：【大数据之数据仓库】GreenPlum PK DeepGreen（TPCH）


下一篇：MongoDB大数据高并发读写性能测试报告