TWO——Django项目环境搭建（创建Django项目【虚拟机中创建虚拟环境和django项目】；创建pycharm项目并运行） | Django项目设置 | 使用码云平台（创仓；下项目；推送项目）

项目环境搭建

目前使用的VirtualBox以及pycharm及其版本：

一、创建django项目

1.创建python虚拟环境

在虚拟机上创建python虚拟环境，因为实际项目部署，实在linux(/usr/bin可以省略，但是一定要指定python3版本)

mkvirtualenv -p /usr/bin/python3.6 newproject				

2.创建django项目

1.安装django

选择安装django2.1.x最新的一个版本2.1.10

pip install django==2.1.10

2.创建django项目

cd ~/project/		# cd到你想放django项目路径的地方
django-admin startproject new2project

3.创建pycharm项目

通过pycharm的远程项目，连接虚拟机，开发。

1.选择项目目录（在桌面新建一个名为newblog2的空文件夹，使用pycharm打开）

选择你要存放项目文件的目录，注意django项目和pycharm项目的根目录一定要保持一致，不要用一个pycharm的项目，管理多个django项目。

2.项目一些基本配置

注意：
Name 修改名字，推荐和项目同名。一定要改！

注意：
Root path一定选择刚刚在远程虚拟机中创建的django项目的根目录，一定是根目录！

3.配置远程解释器

配置刚才创建的虚拟解释器

选择ssh
Host是添加远程主机地址，因为是nat模式，做了端口映射，所以是127.0.0.1；
Port是端口号，与端口映射中主机端口保持一致！

ubuntu中网络转发设置：

4.下载代码

5.打开远程项目目录窗口：

6.设置同步：

7.运行项目：（这次换个更快捷的运行方法！）

首先，直接运行manage.py文件：

会报错咱的manage.py没有配置端口和ip！
所以，来进行配置：

小火箭已出，项目OK！

二、django项目设置

1.配置模板文件

在项目跟目录下创建一个template文件夹

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        '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',
            ],
            # 将模板标签内置到模板中 https://docs.djangoproject.com/en/2.1/topics/templates/
            'builtins': ['django.templatetags.static'],
        },
    },
]

2.配置mysql数据库

1.创建数据库(使用utf8mb4可以包含一些键盘特殊符号)

mysql> create database newproject charset=utf8mb4;
Query OK, 1 row affected (0.00 sec)

2.配置settings（两种方法！）

方法一：直接在settings.py文件中添加数据库配置信息（本人使用！）

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',               # 数据库引擎
        'NAME': 'newproject',                                # 数据库名
        'USER': 'root',                                  # 用户名
        'PASSWORD': 'qwe123',                            # 密码
        'HOST': '127.0.0.1',                                # 主机IP
        'PORT': 3306                                        # 端口
    }
}

方法二：将数据库配置信息存到一个文件，在settings文件中将其引入。（推荐）

新建数据库配置文件db.cnf(名字随意)

db.cnf文件内容：

[client]
database = tzproject
user = dj_user
password = pythonvip
host = 127.0.0.1
port = 3306
default-character-set = utf8

在settings.py文件中引入db.cnf

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'OPTIONS':{
            'read_default_file': 'utils/db/db.cnf'
        }
    }
}

官方文档

3.安装mysql数据库的python驱动

mysql数据库配置完成后，运行django服务会报如下错误，官方推荐安装mysqlclient1.3.7以上版本，也可以安装pymysql，并且需要在settings.py文件所在目录包中的__init__.py中导入pymysql。

第一种方法：安装mysqlclient

# 首先更新ubuntu
sudo apt-get update 

# 然后按照依赖库
sudo apt-get install default-libmysqlclient-dev

# 再切换到虚拟环境中
workon newproject

# 最后安装mysqlclient
pip install mysqlclient -i https://pypi.doubanio.com/simple

第二种方法：安装pymysql

# 安装pymysql
pip install pymysql

在settings.py文件所在目录下的__init__.py导入：

4.配置redis缓存

用于存放用户session信息，以及需要缓存的各种信息。（注意一定要指定django-redis的版本为4.11.0，如果安装其它版本可能会出现导致django自动升级为3.0.7版本）

# 在虚拟机中安装django-redis
pip install django-redis==4.11.0	

# settings.py文件中指定redis配置
# session存储缓存设置
SESSION_ENGINE = 'django.contrib.sessions.backends.cache'
SESSION_CACHE_ALIAS = 'session'
CACHES = {
    "default": {
        "BACKEND": "django_redis.cache.RedisCache",
        "LOCATION": "redis://127.0.0.1:6379/0",
        "OPTIONS": {
            "CLIENT_CLASS": "django_redis.client.DefaultClient",
        }
    },
    'session': {
        'BACKEND': 'django_redis.cache.RedisCache',
        'LOCATION': 'redis://127.0.0.1:6379/1',
        'OPTIONS': {
            'CLIENT_CLASS': 'django_redis.client.DefaultClient',
        }
    },
}

文档地址

django文档

为何要用 django-redis ?

因为:

• 持续更新
• 本地化的 redis-py URL 符号连接字符串
• 可扩展客户端
• 可扩展解析器
• 可扩展序列器
• 默认客户端主/从支持
• 完善的测试
• 已在一些项目的生产环境中作为 cache 和 session 使用
• 支持永不超时设置
• 原生进入 redis 客户端/连接池支持
• 高可配置 ( 例如仿真缓存的异常行为 )
• 默认支持 unix 套接字
• 支持 Python 2.7, 3.4, 3.5 以及 3.6

5.配置日志器 官方文档

用于记录系统运行过程中的各种日志信息。

在项目根目录中创建一个logs文件夹，用于存放日志文件

# 日志
LOGGING = {
    # 版本
    'version': 1,
    # 是否禁用已存在的日志器
    'disable_existing_loggers': False,
    'formatters': {
        'verbose': {
            'format': '{levelname} {asctime} {module} {lineno:d} {message}',
            'style': '{',
        },
        'simple': {
            'format': '{levelname} {module} {lineno:d} {message}',
            'style': '{',
        },
    },
    'filters': {
        'require_debug_true': {
            '()': 'django.utils.log.RequireDebugTrue',
        },
    },
    'handlers': {
        'console': {
            'level': 'DEBUG',
            'filters': ['require_debug_true'],
            'class': 'logging.StreamHandler',
            'formatter': 'simple'
        },
        'file': {
            'level': 'INFO',
            # 这个handler可以记录一组日志文件
            'class': 'logging.handlers.RotatingFileHandler',
            'filename': os.path.join(BASE_DIR, 'logs/tz_django.log'),
            # 单个日志文件最大字节数
            'maxBytes': 300*1024*1024,
            # 日志文件个数
            'backupCount': 10,
            'formatter': 'verbose'
        },
    },
    'loggers': {
        'django': {
            'handlers': ['console', 'file'],
            'level': 'INFO',  # 日志器接收的最低级别
            'propagate': True,
        },
    },
}

使用方法（此处先不举例说明，后面码代码时详细说明！）

# 使用方法
# import the logging library
import logging

# Get an instance of a logger
# 此处的django为，settings.py文件中，LOGGING配置下的loggers中定义的日志器名称
logger = logging.getLogger('django')	

def my_view(request, arg1, arg):
    ...
    if ***:
        # Log an error message
        logger.error('Something went wrong!')

6.时区配置

# 修改语言
LANGUAGE_CODE = 'zh-hans'
# 修改时区
TIME_ZONE = 'Asia/Shanghai'

USE_I18N = True

USE_L10N = True
# 使用时区
USE_TZ = True

7.静态文件配置

在项目根目录创建一个static目录，用于存放静态文件(css, js, image, font等)
STATIC_URL = '/static/' STATICFILES_DIRS = [ os.path.join(BASE_DIR, 'static') ]

8.创建应用

本项目主要由4个模块组成，分别为新闻文章模块，课程视频播放模块，文档下载模块，用户管理模块等。在项目根目录下创建一个apps目录用于存放各子应用。

然后cd到apps目录创建各子应用

再到settings文件中，加入如下设置

import sys 

# 创建应用之后，把apps目录加入到sys.path中
sys.path.insert(0, BASE_DIR)
sys.path.insert(1, os.path.join(BASE_DIR, 'apps'))

接着分别在apps文件夹和项目根目录文件夹上右键，加入到Source Root中，优化导入路径(pycharm提示)。

最后将应用添加到INSTALLED_APPS列表中

INSTALLED_APPS = [
	# ...
    'user',
    'news',
    'doc',
    'course'
]

注意：目前安装的所有包及其版本如下：

三、在码云平台创建项目

git服务平台：

• 主要使用github（最主流）
  • 国内访问速度慢
  • 托管私有项目收费
• 国内一般使用码云gitee
  • 国内访问速度快
  • 托管私有项目免费（限制开发人数）
• 公司中使用gitlab或者svn来搭建

创建步骤：

1.注册码云账号 注册

2.创建仓库

1.登录码云后，通过网站右上角的「+」号，选择「新建仓库」，进入新建仓库页面

2.填写仓库信息

3.点击「创建」，即可在码云上创建你的第一个仓库。

3.生成ssh公钥

首先，在本地项目文件夹中打开Git窗口执行初始化命令：

然后，执行命令生成SSH Key：

ssh-keygen -t rsa -C '[email protected]'

按照提示完成三次回车，即可生成ssh key。通过查看~/.ssh/id_rsa.pub文件内容，获取到你的public key

cat ~/.ssh/id_rsa.pub
# ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQC6eNtGpNGwstc....

最后，复制生成后的 ssh key，通过设置主页「SSH公钥」->「添加公钥」，添加生成的public key到仓库中。

小拓展：可使用命令cat ~/.ssh查看到公钥私钥在本地储存的位置：

4.克隆项目到本地

复制ssh链接
克隆项目到虚拟机或者物理机都可以。

git clone 复制的ssh链接

5.添加远程仓库

如果是先在本地建立了项目， 再在码云上创建远程仓库，那么操作如下。

1. 首先cd到django项目根目录，然后创建git本地仓库

cd ~/project/newproject
git init

2.然后添加远程仓库

git remote add origin  git@gitee.com:wcflove/tztz.git

四、将项目推送到码云

**注意：
1.我使用的方式是——先在码云上创建了一个空仓库；然后在本地电脑中搭建的项目；最后将本地项目推送到码云中刚刚创建的空仓库中。
2.而且刚刚在本地设置了公钥，一定要在码云中添加公钥。因为本次使用的是SSH。
**

手动同步代码(更保险)，然后运行django服务，检查无误后就可以提交代码，然后推送到码云了

• 编写.gitignore文件
  为了让git的运行速度更快，有些不需要添加到仓库的文件比如pycharm的项目设置文件.idea文件夹，可以通过.gitignore文件来设置忽略.idea文件夹， 在.gitignore文件的最后加上下面两行

  # pycharm
  .idea/
  

• 配置好推送人的身份信息（填写自己的名字和邮箱地址）

$ git config user.name "first"
$ git config user.email "[email protected]"

• 将代码推送至本地仓库

# 工作区添加到暂存区
$ git add .
# 暂存区提交到仓库
$ git commit -m 'first commit'

• 将代码推送到码云

 git remote add origin git@gitee.com:beautifulboyfriend/first.git

git push -u origin master

注意，如果出现，推送失败就需要运行强推

$ git push -f origin master

• 码云中就出现了，你本次写的代码

小知识点讲解：

你在使用码云创建好一个仓库之后会显示如下界面，而我们将本地项目推送到码云也是参考这里面的提示来的：

（1）理解SSH：

本次我们使用的是SSH，为啥呢？因为咱们刚刚生成了SSH公钥并且将其添加到了咱的码云中。怎么理解我们干这些的用意？
简言之——上面我们在本地生成SSH公钥的时候，同时生成了一个公钥和一个私钥。而我们可以将这个公钥看成一把锁；将这个私钥看成是一把开这个锁的钥匙。这就是为咱们电脑和码云之间创建连接的安全着想的。
我们将公钥配置到了我们的码云上面，所以我们本地的那个私钥一定不能删除了，因为我们每次提交项目到码云的时候，都会自动携带这个私钥（钥匙），才能成功的提交，你可以尝试：如果码云中没有配置公钥，提交的时候是会报错的！

（2）理解HTTPS：

难道HTTPS就不安全了么？怎么可能，如果使用HTTPS的话，我们每次和码云建立连接提交的时候，都会要求我们输入用户名及密码，但是因为本地凭证中已经有了，所以每次建立连接提交的时候就自动携带了！你同样可以尝试：如果你讲本地的凭证删了，提交的时候同样是不会成功的！