详解Django配置优化方法

yipeiwu_com5年前Python基础

​一、使用多个setting文件

 开发Django项目是最常见,也是最麻烦的一个问题就是如何区分开发配置与线上配置。有一些解决方案是利用配置文件是py文件这个特性,在配置里面写一些 if-else 来达到区分线上配置与开发配置的目的。但是当项目较为复杂的时候,这样写的可读性十分差,而且可能产生一些条件判定的BUG。

​ 所以更加推荐的方法是使用多个配置文件。

​ 例如新建一个Django项目的时候,默认结构如下:

myDemoSite
├── manage.py
└── myDemoSite
 ├── __init__.py
 ├── settings.py
 ├── urls.py
 └── wsgi.py

新建一个 settings 的文件夹

里面新建 base.py , dev.py , production.py 这三个文件,并删掉 settings.py 文件。

myDemoSite
├── manage.py
└── myDemoSite
 ├── __init__.py
 ├── settings						<- add
 │   ├── __init__.py			<- add
 │   ├── base.py					<- add
 │   ├── dev.py					<- add
 │   └── production.py		<- add
 ├── urls.py
 └── wsgi.py

base.py 里面是公用的配置,例如 SECRET_KEYINSTALLED_APPS

dev.py 里面是开发环境下的配置,例如 DEBUG=True 、开发环境数据库等

production.py 里是生产环境下的配置,例如线上库的连接等

分别在 dev.py 、 production.py 里引入 base.py

# dev.py 和 production.py
from myDemoSite.settings.base import *

​ 一般在python里面不建议通过 * 来导入,因为可能会引发变量名冲突等异常。但在这里是个例外,因为 base.py 里面是我们的公共配置变量,通过变量名的方法导入的话,代码也会很难看,而且麻烦。

指定配置文件

1. 命令行模式指定配置文件

当使用多配置文件并运行 python manage.py runserver 命令的时候,需要注意的是 Django 此时会报错。

Traceback (most recent call last):
 File "manage.py", line 21, in <module>
 main()
 File "manage.py", line 17, in main
 execute_from_command_line(sys.argv)
……

 File "/python3.7/site-packages/django/conf/__init__.py", line 176, in __init__
 raise ImproperlyConfigured("The SECRET_KEY setting must not be empty.")
django.core.exceptions.ImproperlyConfigured: The SECRET_KEY setting must not be empty.

原因在于我们将 settings.py 文件给删掉了, Django 引擎找不到配置文件。

因此在这里需要手动指定配置文件,只需要在运行命令后加上 --setting 即可: python manage.py runserver --settings=myDemoSite.settings.dev

$> python manage.py runserver --settings=myDemoSite.settings.dev
Watching for file changes with StatReloader
Performing system checks...

System check identified no issues (0 silenced).

You have 17 unapplied migration(s). Your project may not work properly until you apply the migrations for app(s): admin, auth, contenttypes, sessions.
Run 'python manage.py migrate' to apply them.

Django version 2.2.7, using settings 'myDemoSite.settings.dev'
Starting development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.

2. Pycharm指定配置文件

如果你是使用的专业版的Pycharm,你一定是习惯直接使用Pycharm来启动服务的方式。这里我们也可以通过修改Pycharm的运行配置信息来达到指定 settings 配置的目的:

 

  1. 修改配置文件里 Environment variables 配置。添加或修改 DJANGO_SETTINGS_MODULE 参数为 ProjectName.settings.dev
  2. 添加 production 环境下的配置文件,然后重复第1步

使用多个配置环境带来的另一个好处就是,我们还可以根据不同的端口号来使用不同的环境。例如我可以在 8000 端口使用开发环境的配置,在 8001 端口使用模拟生产环境的配置,这样子带来的好处是我们在开发的时候可以同时兼顾多个环境下的状态。

二、使用本地文件管理敏感配置信息

亲爱的朋友,当你辛辛苦苦写好了一个项目,并准备把它开源到github的时候,你一定不希望将你的数据库连接方式也一同上传上来。 可是配置文件又必须得上传,这个时候我们就需要用到 Django-environ 来管理我们的私密信息。

安装方式

使用pip安装

pip install django-environ

官方文档

https://django-environ.readthedocs.io/en/latest/

https://github.com/joke2k/django-environ

使用方法

django-environ 的使用十分简单

在项目下新建一个 .env 文件,内容就是数据库连接等需要保密的字段,例如:

DEBUG=on
SECRET_KEY=your-secret-key
DATABASE_URL=psql://urser:un-githubbedpassword@127.0.0.1:8458/database
SQLITE_URL=sqlite:///my-local-sqlite.db
CACHE_URL=memcache://127.0.0.1:11211,127.0.0.1:11212,127.0.0.1:11213
REDIS_URL=rediscache://127.0.0.1:6379/1?client_class=django_redis.client.DefaultClient&password=ungithubbed-secret 

注意:

.env 文件需要添加到你的 .gitignore 文件里,这样才能保护到你的隐私

开源项目可以添加一个 .env.example

在你的setting文件里使用它

# base.py
import environ

ROOT_DIR = environ.Path(__file__)-3 # 获取.env文件的路径
#> environ.Path(__file__)获取到的是base.py的 绝对路径 
#> '/demoProjects/myDemoSite/myDemoSite/settings/base.py'
#> environ.Path(__file__)-3 切换到前三层目录
#> '/demoProjects/myDemoSite'

env = environ.Env()
env.read_env(ROOT_DIR.path('.env').root)

DEBUG = env.bool('DEBUG')
# DEBUG = True
# dev.py
from myDemoSite.settings.base import *

DEBUG = env.bool('DEBUG')
# DEBUG = True

environ.Path() 函数是对 os.Path() 的一个补充,支持了 - 操作

django-environ 支持 boolstrlistdictint 等多种数据类型

db_url 会被转换成 django 配置所需要的格式

# .env
DEV_MYSQL=mysql://user:%23password@127.0.0.1:3306/dbname
  
# dev.py
> env.db_url('DEV_MYSQL')
> <class 'dict'>: {'NAME': 'dbname', 'USER': 'user', 'PASSWORD': '#password', 'HOST': '127.0.0.1', 'PORT': 3306, 'ENGINE': 'django.db.backends.mysql'}

总结

本文介绍使用了多个配置文件区分开发、生产环境,使用 django-environ 管理敏感配置信息的方法。

根据个人习惯,也同样可以使用多个 .env 配置+ 一个 setting.py 配置来实现区分开发、生产环境的目的。

在命令行可以指定所使用的 .env 文件:

PROJECT_ENV=dev python manage.py 

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持【听图阁-专注于Python设计】。

相关文章

一篇文章入门Python生态系统(Python新手入门指导)

一篇文章入门Python生态系统(Python新手入门指导)

译者按:原文写于2011年末,虽然文中关于Python 3的一些说法可以说已经不成立了,但是作为一篇面向从其他语言转型到Python的程序员来说,本文对Python的生态系统还是做了较为...

Python简单删除列表中相同元素的方法示例

本文实例讲述了Python简单删除列表中相同元素的方法。分享给大家供大家参考,具体如下: 去除列表中重复的元素,非常简单,直接上代码: a = [11, 21, 3, 4, 3, 2...

理解Python中的With语句

With语句是什么? 有一些任务,可能事先需要设置,事后做清理工作。对于这种场景,Python的with语句提供了一种非常方便的处理方式。一个很好的例子是文件处理,你需要获取一个文件句柄...

用Python批量把文件复制到另一个文件夹的实现方法

0 前言 大概是三个月前,有个人找我说要我帮忙写几行代码,功能是把一个文件夹里面的所有文件拆分成 200 个文件一个文件夹,很简单的。 我理解了之后,觉得还是挺简单的,花了半个小时写出...

python字符串和常用数据结构知识总结

python字符串和常用数据结构知识总结

使用字符串 第二次世界大战促使了现代电子计算机的诞生,当初的想法很简单,就是用计算机来计算导弹的弹道,因此在计算机刚刚诞生的那个年代,计算机处理的信息主要是数值,而世界上的第一台电子计...