最全的Django入门及常用配置
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
-
可以看作Django项目的工具，通过它来调用Django shell和数据库
- 比如"操作数据库(在数据库中生成表)"，"启动项目"，"创建应用"等
-
启动文件，寻找其他模块的路径开始位置
- 通过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映射中路径定义一个规范- 路径必须以
^开始，以$结束- 不加结束符时，
r'^/jesi/'可以匹配r'ziawang/xxxxxxxxxx/asdasd'
- 不加结束符时，
- 路径指向文件时，不在结尾添加
/r'^jesi/index.html$'
- 路径不指向文件时，应在路径末尾添加
/r'^jesi/index/$'
- 所有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
- href中的
- 如果使用
<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服务器替换内置的服务器。
梦想随心，天地随行
