Django配置优化方法

一、使用多个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.pyproduction.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配置的目的:

image

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

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

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

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

安装方式

使用pip安装

pip install django-environ

官方文档

  1. https://django-environ.readthedocs.io/en/latest/#django-environ
  2. https://github.com/joke2k/django-environ

使用方法

django-environ的使用十分简单

  1. 在项目下新建一个.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

  1. 在你的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 
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 220,976评论 6 513
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 94,249评论 3 396
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 167,449评论 0 360
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 59,433评论 1 296
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 68,460评论 6 397
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 52,132评论 1 308
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,721评论 3 420
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,641评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 46,180评论 1 319
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 38,267评论 3 339
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 40,408评论 1 352
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 36,076评论 5 347
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,767评论 3 332
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 32,255评论 0 23
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 33,386评论 1 271
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,764评论 3 375
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 45,413评论 2 358

推荐阅读更多精彩内容