TWO——Django项目环境搭建（创建Django项目【虚拟机中创建虚拟环境和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 '1915344876@qq.com'

按照提示完成三次回车，即可生成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.添加远程仓库

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

首先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 "1915344876@qq.com"

• 将代码推送至本地仓库

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

• 将代码推送到码云

git remote add origin git@gitee.com:beautifulboyfriend/first.gitgit push -u origin master

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

$ git push -f origin master

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

小知识点讲解：

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

（1）理解SSH：

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

（2）理解HTTPS：

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