Django项目前期项目配置

创建仓库及克隆

    在git或者码云上创建远程项目仓库，创建后打开git客户端，切换到你要管理项目的目录下执行 ”git clone 远程仓库地址“执行

克隆的文件下会存在.git和.gitignore 两个隐藏文件，使用编辑器打开.gitgnore文件添加.idea（为了忽略idea文件，不用git去管理他，避免冲突）

    

创建项目：

pip3 install virtualenv

    创建虚拟环境：

mkvirtualenv -p python3 meiduo_mall    或者    python3  -m venv 虚拟环境名称

    进入虚拟环境

    切换到bin/目录下 source activate    source 虚拟环境名称/bin/activate

pip install django==1.11.11

    创建工程

django-admin startproject meiduo_mall
（退出虚拟环境：deactivate）

配置jinja2模板引擎：

    目的：项目使用Jinja2模板引擎渲染页面

    步骤：安装Jinja2扩展包、配置Jinja2模板引擎、补充Jinja2模板引擎环境变量

安装Jinja2模板引擎：pip3 install Jinja2

 在项目工程目录的setting中配置Jinja2模板引擎配置：

TEMPLATES = [

{

        'BACKEND': 'django.template.backends.jinja2.Jinja2',  # 配置jinja2引擎模板

        'DIRS': [os.path.join(BASE_DIR, 'templates')],  # 配置模板文件的路径

        'APP_DIRS': True,

        'OPTIONS': {

            'context_processors': [

                'django.template.context_processors.debug',

                'django.template.context_processors.request',

                'django.contrib.auth.context_processors.auth',

                'django.contrib.messages.context_processors.messages',

            ],

            # 补充jinja2模板引擎环境

            'environment': 'meiduo_mall.utils.jinja2_env.jinja2_environment',

        },

    },

    {

        'BACKEND': 'django.template.backends.django.DjangoTemplates',

        'DIRS': [],

        'APP_DIRS': True,

        'OPTIONS': {

            'context_processors': [

                'django.template.context_processors.debug',

                'django.template.context_processors.request',

                'django.contrib.auth.context_processors.auth',

                'django.contrib.messages.context_processors.messages',

            ],

        },

    },

]

注：django原有的模板引擎置于jinja2模板配置之后不能注释掉，否则可能会报错。

在调整DIRS（模板文件路径）参数前要在工程目录下新建一个跟配置文件同级的templates模板文件package，创建完成后右键选择Mark Directory as—>选择Template Folder,

这是由会有一个弹窗选择yes，出现了pycharm的setting菜单的Preferences页，选择Template Language项，选择Jinja2。这样做的目的是为了在用编辑器写Jinja2模板语法的时候有提示信息。

新建一个package：utils（存放项目所有的工具文件)下面创建一个jinja2_env.py文件，写入一下代码：（这么做的原因就是因为Jinja2的模板部分语法易用性较差）

from django.contrib.staticfiles.storage import staticfiles_storage

from django.urls import reverse

from jinja2 import Environment



def jinja2_environment(**options):

    """jinja2环境"""

    # 创建环境对象

    env = Environment(**options)

    # 自定义语法： {{ static('静态文件相对路径') }}  加载静态文件      # {{ url('路由的命名空间') }}  重定向使用

    env.globals.update({

        'static': staticfiles_storage.url,  # 获取静态文件的前缀

        'url': reverse,  # 反向解析

    })

    # 返回环境对象

    return env

配置MySQL数据库：

    ①目的：在django项目中使用mysql数据库存储信息

    ②步骤：新建mysql数据库、配置mysql数据库、安装pyMySQL扩展包

连接mysql创项目需要的数据库（创建完数据库最好新建一个单独的用户去管理这个数据库）

在项目工程目录的setting中配置数据库配置：

DATABASES = {

    'default': {

        'ENGINE': 'django.db.backends.mysql',

        'HOST': ‘数据库连接的host地址',

        'PORT': 3306,

        'USER': 'root',

        'PASSWORD': '123456',

        'NAME': 'goudan',

    }

}

安装pyMySQL：pip3 install PyMySQL,安装完成后再项目的项目主工程的__init__.py文件下面写入以下代码

from pymysql import install_as_MySQLdb

install_as_MySQLdb()  # 因为Django的orm使用的是python2的mysqldb而我们安装的是pymsql

配置Redis数据库：

    ①目的：使用redis数据库存储缓存数据和状态保持数据等

    ②步骤：安装django_redis扩展包、配置redis数据库（参考文档：https://django-redis-chs.readthedocs.io/zh_CN/latest/)

  在项目工程目录的setting中配置redis数据库：

# 配置Redis数据库

CACHES = {

    "default": {  # 默认

        "BACKEND": "django_redis.cache.RedisCache",

        "LOCATION": "redis://redis服务器的ip:6379/0",

        "OPTIONS": {

            "CLIENT_CLASS": "django_redis.client.DefaultClient",

        }

    },

    "session": {  # session

        "BACKEND": "django_redis.cache.RedisCache",

        "LOCATION": "redis://redis服务器的ip:6379/1",

        "OPTIONS": {

            "CLIENT_CLASS": "django_redis.client.DefaultClient",

        }

    },

}

SESSION_ENGINE = "django.contrib.sessions.backends.cache"

SESSION_CACHE_ALIAS = "session"

     注：要对redis0-15号库进行分库德华直接就在复制一个配置项中的default在CACHES的配置字典中，选择你要存储的库就可以。

配置工程日志：

    ①目的：使用日志文件记录网站的输入信息，用于调试，排查及日志分析

    ②步骤：配置工程日志、准备日志文件目录、日志器的使用、GIT管理工程日志

 

在项目工程目录的setting中配置工程日志：

LOGGING = {

    'version': 1,

    'disable_existing_loggers': False,  # 是否禁用已经存在的日志器

    'formatters': {  # 日志信息显示的格式

        'verbose': {

            'format': '%(levelname)s %(asctime)s %(module)s %(lineno)d %(message)s'

        },

        'simple': {

            'format': '%(levelname)s %(module)s %(lineno)d %(message)s'

        },

    },

    'filters': {  # 对日志进行过滤

        'require_debug_true': {  # django在debug模式下才输出日志

            '()': 'django.utils.log.RequireDebugTrue',

        },

    },

    'handlers': {  # 日志处理方法

        'console': {  # 向终端中输出日志

            'level': 'INFO',

            'filters': ['require_debug_true'],

            'class': 'logging.StreamHandler',

            'formatter': 'simple'

        },

        'file': {  # 向文件中输出日志

            'level': 'INFO',

            'class': 'logging.handlers.RotatingFileHandler',

            'filename': os.path.join(os.path.dirname(BASE_DIR), 'logs/meiduo.log'),  # 日志文件的位置

            'maxBytes': 300 * 1024 * 1024,  # 日志文件的大小

            'backupCount': 10,  # 日志文件的最大个数

            'formatter': 'verbose'

        },

    },

    'loggers': {  # 日志器

        'django': {  # 定义了一个名为django的日志器

            'handlers': ['console', 'file'],  # 可以同时向终端与文件中输出日志

            'propagate': True,  # 是否继续传递日志信息

            'level': 'INFO',  # 日志器接收的最低日志级别

        },

    }

}

准备日志文件目录：

    创建跟主工程同级的文件夹Directory命名为logs，支持上一步操作在日志文件的位置，否则启动项目会报错

日志器的使用： 

    在你需要的打印日志的地方调用日志器就可以

import logging

# 创建日志记录器

logger = logging.getLogger(‘django’)

# 输出日志

logger.debug('测试logging模块debug’)

logger.debug('测试logging模块info’)

logger.debug('测试logging模块error’)

Git管理(空文件)工程目录：

    工程目录下logs文件夹下面的日志是不需要托管到git上的，因为是调试日志而且还可能会引起不必要的冲突，但是git会自动忽略*.log文件,这样就导致工程目录下的logs文件件一直会是空的，那么当我们需要让git管理空的文件夹的时候，git给我们提供了一个方法，在文件目录下创建一个名为”.gitkeep“的隐藏文件，这样就能将空文件目录托管到git当中了。

配置静态文件：

    首先将静态文件资源放到主工程目录下与settings、templates等文件同级，在setting配置文件中找到STATIC_URL= ’/static’配置，下面添加配置代码

# 制定加载静态文件的路由前缀

STATIC_URL = '/static/'

# 配置静态文件的加载路径

STATICFILES_DIRS = [os.path.join(BASE_DIR, 'static')]

注：开发过程中将代码放置到工程目录下，待开发完成部署线上的时候，要将静态资源防止到Nginx服务器上挂在，进行静态资源转发。

 

至此，djangoweb项目框架前期准备已基本完成，后续一些配置要在项目的编写过程中逐步丰盈.....   大家一起成长~