Django框架全步骤

文章原文出自：https://dmyz.org/archives/110
Django+MySQL安装配置详解(Linux)[更新为2.1.5版]
前言

Django是一个开源的Web应用框架，由Python写成，并于2005年7月在BSD许可证下发布。Django的主要目标是使得开发复杂的、数据库驱动的网站变得简单。Django采用MVC设计模式注重组件的重用性和“可插拔性”，敏捷开发和DRY法则（Don’t Repeat Yourself）。在Django中Python被普遍使用，包括设置和数据模型。本文介绍Django在Linux(Ubuntu 16.04.2)+MySQL(5.7.43)环境下安装、配置的过程，包括安装、运行、添加应用的流程，建立一个可以从MySQL读取文章并显示的Django应用。文章面向刚接触Python/Django的初学者，所以安装过程都以默认环境为主，Python版本3.5.2。
安装

首先从 https://www.djangoproject.com/download/2.1.5/tarball/ 下载Django，解压并安装：

python -c “import urllib.request;urllib.request.urlretrieve (‘https://www.djangoproject.com/download/2.1.5/tarball/’, ‘Django-2.1.5.tar.gz’)”
tar xzvf Django-2.1.5.tar.gz
cd Django-2.1.5/
sudo python setup.py install

完成安装后，Django会拷贝django-admin.py到/usr/local/bin下，这个py文件引入了Django的管理模块。Django更常见的安装方式参看virtualenv, pipenv
创建项目

使用startproject命令创建一个Django项目，输入项目名称，例如dmyz：

django-admin startproject dmyz

Django会在当前目录下自动生成一个名为dmyz的文件夹，里面有以下文件：

dmyz/
|-- dmyz
| |-- init.py
| |-- settings.py
| |-- urls.py
| -- wsgi.py– manage.py

目录下与项目同名的应用里(本例中是dmyz)存放设置文件，所以下文的项目文件夹指的是dmyz，注意不要和dmyz/dmyz文件夹混淆。

manage.py：和django-admin相同，但会设置环境变量为当前项目的设置文件
dmyz/__init__.py：Python特性，可以是空文件，表明这个文件夹是一个可以导入的包
dmyz/settings.py：设置文件，本文主要修改数据库信息、模板目录、加载模块的信息
dmyz/urls.py：URL路由，指定函数与URL的映射关系
dmyz/wsgi.py：本文中不会使用，nginx/apache+wsgi在生产环境中运行Django时使用。

创建完成后，在项目文件夹执行runserver启动Django自带的开发服务器，如果修改文件，开发服务器会自动重启。启动时执行检查，如果正常则顺利启动：

python manage.py runserver

访问http://127.0.0.1:8000，如果顺利显示，说明Django开发服务器已经成功启动。但现在只有本机可以访问，要让外网能够访问，或是要更换默认的端口，可以增加参数：

$ python manage.py runserver 0.0.0.0:8080

这样就将端口修改为8080，且外网也可以通过IP访问本机上的Django。
数据库配置

现在要让Django支持MySQL数据库。编辑设置文件(dmyz/dmyz/settings.py)。找到DATABASES的设置，当前版本是在76行，默认是sqlite，把它改成MySQL：

DATABASES = {
‘default’: {
‘ENGINE’: ‘django.db.backends.mysql’, #设置为mysql数据库
‘NAME’: ‘dmyz’, #mysql数据库名
‘USER’: ‘root’, #mysql用户名，留空则默认为当前linux用户名
‘PASSWORD’: ‘root’, #mysql密码
‘HOST’: ‘’, #留空默认为localhost
‘PORT’: ‘’, #留空默认为3306端口
}
}

代码的中文注释，在不指定Python文件编码的情况下会引起SyntaxError，不要复制这些中文注释。下文的中文注释同理。

Django(Python)操作MySQL依赖第三方包，要先安装mysqlclient。

python -c “import urllib.request;urllib.request.urlretrieve (‘https://github.com/PyMySQL/mysqlclient-python/archive/v1.4.1.tar.gz’, ‘mysqlclient-python-v1.4.1.tar.gz’)”
tar xzvf mysqlclient-python-v1.4.1.tar.gz
cd mysqlclient-python-1.4.1/
sudo python setup.py install

可能会提示EnvironmentError: mysql_config not found。因为没有安装开发工具包，执行：

sudo apt-get install libmysqld-dev

执行migrate命令，把所有应用的迁移（Migrations）应用到数据库：

python manage.py migrate

如果相关的设置/包都正确，Django会创建下列表：

±---------------------------+
| Tables_in_dmyz |
±---------------------------+
| auth_group |
| auth_group_permissions |
| auth_permission |
| auth_user |
| auth_user_groups |
| auth_user_user_permissions |
| django_admin_log |
| django_content_type |
| django_migrations |
| django_session |
±---------------------------+

URL

现在首页还是默认内容。Django通过urls.py文件来匹配相应的视图。修改dmyz/dmyz/urls.py增加首页的路由：

from django.contrib import admin
from django.urls import path
from . import views #引入views

urlpatterns = [
path(‘admin/’, admin.site.urls),
path(’’, views.home),
]

path用来指定路由，re_path是正则形式的路由，等于之前版本的url。
在dmyz/dmyz/目录下新建views.py文件，内容如下：

from django.http import HttpResponse
def home(request):
return HttpResponse(‘hello, world’)

刷新网站首页，看到已经输出了”hello, world”。
应用

这节编写一个名为articles的应用，从MySQL数据库里读取出文章作者、标题、内容。

首先建立应用，在项目文件夹中执行：

python manage.py startapp articles

运行后在项目文件夹中会创建article文件夹，包含下列文件：

articles/
|-- init.py
|-- admin.py
|-- apps.py
|-- migrations
| -- __init__.py |-- models.py |-- tests.py– views.p

admin.py：当前应用在Django管理界面的设置
migrations：数据库迁移的文件夹，创建的迁移会保存在这个文件夹里
models.py：模型文件，用Python类来描述数据表。
views.py：视图文件，用来联系模型与模版，主要的业务逻辑一般都写在这里
tests.py：单元测试文件

生成应用之后，要修改设置文件，告诉Django这个应用是属于当前项目的。打开设置文件(dmyz/dmyz/settings.py)，找到INSTALLED_APPS列表，增加articles：

INSTALLED_APPS = [
‘django.contrib.admin’,
‘django.contrib.auth’,
‘django.contrib.contenttypes’,
‘django.contrib.sessions’,
‘django.contrib.messages’,
‘django.contrib.staticfiles’,

'articles', #加入应用

]

然后编辑模型文件(article/models.py)：

from django.db import models

Create your models here.

class Article(models.Model):
title = models.CharField(max_length=64)
author = models.CharField(max_length=32)
content = models.TextField()

def __str__(self):
    return self.title

执行makemigrations，Django会根据模型文件自动生成迁移文件：

python manage.py makemigrations

应用迁移：

python manage.py migrate

MySQL数据库会创建名为articles_article的表，包含默认的主键和之前定义的字段：

±--------±------------±-----±----±--------±---------------+
| Field | Type | Null | Key | Default | Extra |
±--------±------------±-----±----±--------±---------------+
| id | int(11) | NO | PRI | NULL | auto_increment |
| title | varchar(64) | NO | | NULL | |
| author | varchar(32) | NO | | NULL | |
| content | longtext | NO | | NULL | |
±--------±------------±-----±----±--------±---------------+

模型就设置完成了，现在编辑应用的视图(articles/views.py)文件：

from django.shortcuts import render
from .models import Article #引入之前定义的model

def articles(request):
article_list = Article.objects.order_by(’-id’)
return render(request, ‘articles.html’, {‘article_list’: article_list})

编辑项目的urls.py文件(dmyz/dmyz/urls.py)，导入articles的视图：

from django.conf.urls import include, url
from django.contrib import admin

from . import views
from articles import views as articles_views #导入articles的views

urlpatterns = [
path(‘admin/’, admin.site.urls),
path(’’, views.home),
path(‘articles/’, articles_views.articles),
]

现在访问http://127.0.0.1:8000/articles/，会报错TemplateDoesNotExist at 路径，因为还没有告诉Django到哪里去找articles.html文件。

编辑设置文件(dmyz/dmyz/settings.py)，找到TEMPLATES设置，在DIRS中设置一个模版路径，这里将模版目录指定为项目文件夹下的templates：

TEMPLATES = [
{
‘BACKEND’: ‘django.template.backends.django.DjangoTemplates’,
‘DIRS’: [os.path.join(BASE_DIR, ‘templates’),], #设置模版目录
‘APP_DIRS’: True,
…

创建templates(dmyz/templates)文件夹和articles.html文件(dmyz/templates/articles.html)。如果使用过其它框架或者模板引擎，下面articles.html的内容就很容易看懂了，Django在模版文件中利用相应的标签（Tag）控制变量显示的位置：

{% for article in article_list %}
Author:{{ article.author }}
Title:{{ article.title }}
Content:{{ article.title }}
{% endfor %}

这样所有的配置就完成了，访问 http://127.0.0.1:8000/articles/，Django会自动读取数据库中的内容，并显示在网页上。可以直接在数据库中写入数据，或是在Django的shell中操作：

python manage.py shell
>>> from articles.models import Article
>>> Article.objects.create(title=‘Django’, author=‘perchouli’, content=‘Django+MySQL’)

自动化管理界面

自动化管理界面是Django最受欢迎的特征之一，现在的版本是默认开启的。首先创建一个超级用户：

python manage.py createsuperuser

输入账号、密码、邮箱。创建完成后访问：http://127.0.0.1:8000/admin/ ，使用刚才创建的账号登录。现在还看不到articles应用，编辑articles/admin.py：

from django.contrib import admin

from .models import Article # 导入文章模型

admin.site.register(Article) # 注册文章模型

刷新出现之前添加的应用。
后记

本文的一些设置并不适用于实际生产环境，旨在介绍一些入门知识和快速配置的方法，如果希望更规范的学习Django，首推Django的官方文档。