使用Django-environ来区分不同环境

介绍

就是一个读取环境变量的东西
就2个类: Env/ Path.

基本用法

env.example文件

ALLOWED_HOSTS=www.example1.com,www.example2.comDATABASE_URL='mysql://user:password@127.0.0.1:3306/dbname'DEBUG=TrueDJANGO_LOG_LEVEL='INFO'

ipython交互示例

>> import environ>> env = environ.Env()>> env.str('SHELL')  # 读取环境变量SHELL'/bin/zsh'>> env.str('PATH')'这里显示的是环境变量PATH的内容'>> env.read_env('env.example')  # 从文件读进来>> env.str('DJANGO_LOG_LEVEL')'INFO'>> env.bool('DEBUG', False)  # 可以设置默认值，如果获取不到，就取默认值True>> env.list('ALLOWED_HOSTS')['www.example1.com', 'www.example2.com']>> env.db_url('DATABASE_URL'){'ENGINE': 'django.db.backends.mysql', 'HOST': '127.0.0.1', 'NAME': 'dbname', 'PASSWORD': '#password', 'PORT': 3306, 'USER': 'user'}>> ROOT_DIR = environ.Path('/home/mattkang/mysite/')  # 还可以在settings.py中ROOT_DIR = environ.Path(__file__) - 2 。而不用os.path.dirname(os.path.dirname(os.path.abspath(__file__)))这么麻烦的拼接。>> ROOT_DIR('static')  # 而不用os.path.join(ROOT_DIR, 'static')'/home/mattkang/mysite/static'>> APPS_DIR = ROOT_DIR.path('project')

在我们项目中的使用

只用一个settings.py，而不是多个比如settings/dev.py、settings/prod.py、settings/qa.py。
只需要一个额外的的环境变量来读取不同环境的env文件以区分不同环境。这个环境变量就没法写在env文件了，必须手动指定。假设我们这个环境变量叫PROJECT_ENV。
那么我们在命令行执行任何命令的时候，在前面加上PROJECT_ENV=xxx来指定环境变量。
比如，之前是
python manage.py shell --settings=mysite.settings.dev
现在是
PROJECT_ENV=dev python manage.py shell

之前是
python manage.py runserver --settings=mysite.settings.dev
现在是
PROJECT_ENV=dev python manage.py runserver

当然，也可以export来指定这个环境变量，也可以修改shell配置文件来指定这个环境变量，甚至supervisord和uwsgi的配置文件也可以指定环境变量。

我们的settings.py里面是这样根据PROJECT_ENV来读取不同env文件的。

env = environ.Env()env.read_env('envs/env.%s' % env.str('PROJECT_ENV', 'prod'))  # 在envs文件夹下有env.dev/ env.prod/ env.qa/ env.local文件DEBUG = env.bool('DEBUG', False)SECRET_KEY = env.str('SECRET_KEY')LOGGING = {    'version': 1,    'disable_existing_loggers': False,    'handlers': {        'console': {            'class': 'logging.StreamHandler',        },    },    'loggers': {        'django': {            'handlers': ['console'],            'level': env.str('DJANGO_LOG_LEVEL', 'INFO'),        },    },}......

好处:
1. 安全性。可以将敏感信息放环境变量，而不是代码里。分离开来。
2. 可读性。查看大部分配置的时候只需要看env文件就行了
3. 可维护性。减少代码，简洁清晰。可以只有一份settings.py，一目了然。
4. 灵活性。改配置只需要改环境变量就行了，而不需要改一行代码。

举个例子，如果不用环境变量，是多个settings文件的方式，那么虽然不同环境的LOGGING配置项只有level不一样，却还是得把整个LOGGING配置项的代码都写一遍

LOGGING = {    'version': 1,    'disable_existing_loggers': False,    'handlers': {        'console': {            'class': 'logging.StreamHandler',        },    },    'loggers': {        'django': {            'handlers': ['console'],            'level': 'xxx',   # 虽然只有这里不一样，但是还是得所有环境的settings文件都写一遍这整个LOGGING配置项.         },    },}

而使用环境变量的话，可以很精细的在不一样的地方动态根据环境变量设置。只需要在这一行’level’: env.str(‘DJANGO_LOG_LEVEL’, ‘INFO’)。

更多的可以查看官方文档