第二节：模型（Models）和管理后台（Admin site）

本节内容我们将配置数据库，创建第一个model并且快速了解Django自动生成的管理后台(admin site)

目录

• 数据库配置
• 创建模型
• 激活模型
• 使用Django API
• 介绍Django管理后台
• 创建管理员用户
• 将应用注册到管理后台

数据库配置

打开上一节中新建的项目的配置文件，它是一个普通的python模块。

默认情况下，数据库配置使用SQLite，如果你数据库的新手，或者你仅仅是对Django感兴趣，这是最好的选择。SQLite包含在Python，所以不需要安装任何东西。当你开始你的第一个真正的项目的时候，你可能想

要使用更强大的数据库如PostgreSQL，去避免切换数据库的痛苦。

如果你希望使用另外一个数据库，需要安装对应的数据库驱动并且修改键DATABASES的'default'项为匹配的数据库连接设置：

• ENGINE - 'django.db.backends.sqlite3','django.db.backends.postgresql','django.db.backends.mysql',或者'django.db.backends.oracle', 还有其他的后端引擎。
• NAME - 数据库名称，如果你使用SQLite，设置为你的数据库文件所在的路径；这种情况下NAME是一个完整的绝对路径，包含文件名，默认值为：os.path.join(BASE_DIR, 'db.sqlite3')，这个文件将存放在你项目所在的目录。

如果你不使用SQLite作为你的数据库，那么需要另外的设置如：USER,PASSWORD,和HOST必须要添加。关于databases的详细配置我们将单独讲解。

对于SQLite以外的数据库

如果你使用SQLite以外的数据库，请确保你已经创建了一个数据库，也要确保在mysite/settings.py中提供的用户具有“创建数据库”的权限，允许自动创建一个测试数据库在后面的教程中将会用。如果你使用SQLite不需要做任何事情，数据库文件将会在你需要的时候自动创建。

另外，注意在mysite/settings.py文件的顶部INSTALLED_APPS设置，里面包含当前项目中所有被激活的Django应用的名称。应用可以在多个项目中使用，你可以打包并分发给其他的项目使用。

默认情况下，INSTALLED_APPS包含如下应用：

• django.contrib.admin - 一个管理后台。下面很快将会用到它
• django.contrib.auth - 一个认证系统。
• django.contrib.contenttypes - 一个文档内容类型的框架
• django.contrib.sessions - 一个session框架
• django.contrib.messages - 一个消息框架

这些应用至少使用数据库中的一个表，虽然如此，在我们使用它们之前我们需要在一个数据库里面创建表，可以运行下面的命令做到它：

$ python manage.py migrate

migrate命令将查找INSTALLED_APPS的设置，并且创建符合你在mysite/settings.py文件中配置的数据库的任何有必要的数据库表并且随应用迁移，如果说INSTALLED_APPS里面的应用不需要的话那么在运行migrate之前把它注释或删除掉即可。

创建模型

现在我们定义模型，在我们创建的投票应用中，我们创建两个模型：Question和Choice。Question模型有一个问题内容和一个发布时间。Choice有两个字段：选择文本和投票数。Choice和Question是多对一的关系。

这些概念我们用Python类来代表，编辑 polls/models.py 文件：

from django.db import models

class Question(models.Model):
    question_text = models.CharField(max_length=200)
    pub_date = models.DateTimeField('date published')

class Choice(models.Model):
    question = models.ForeignKey(Question, on_delete=models.CASCADE)
    choice_text = models.CharField(max_length=200)
    votes = models.IntegerField(default=0)

代码很简单，每一个模型是一个继承django.db.models.Model的子类，每一个模型具有很多类变量，每一个变量代表一个数据库字段。每一个字段都是有一个Field类的实例来表示，例如，CharField代表字符字段和DateTimeField代表日期字段。这就告诉Django每一个字段是什么数据类型。Field类的实例的名称（如，choice_text），就是数据库表的字段名。

有些Field类是需要必须参数的，比如CharField，必须要提供max_length的参数。它不仅仅会在数据库架构中用，在验证中也会用到。一个字段可以有多个可选参数，在本例中，我们设置votes的默认值为0；

最后，注意在本例中使用ForeignKey定义了一个关系，它告诉Django每个Choice对应一个Question。Django支持所有的数据库关系：多对一，多对多，一对一。

激活模型

简单的模型定义告诉Django很多信息，有了他，Django可以：

• 创建一个针对这个应用的数据库架构。
• 创建一个Python数据库访问API来访问Question和Choice对象。

但是首先需要告诉我们的Django项目polls应用已经被安装了。再次编辑mysite/settings.py文件，修改INSTALLED_APPS，把'polls.apps.PollsConfig'加入列表，如下所示：

INSTALLED_APPS = [
    'polls.apps.PollsConfig',
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
]

　　注意：INTALLED_APPS列表直接写应用的名称也是可以的（如，'polls'），官方建议是写AppConfig的子类，'polls.apps.PollsConfig'中PollsConfig，这个类在创建应用时已经自动创建好了，在polls/apps.py文件里面定义，这个类里面可以定义关于应用的一些元数据如应用名称，描述等信息，Django提供了一些公用API可以读取里面的配置信息，暂时没有发现其他什么特别的用处。

现在Django已经知道包含了polls应用了，运行另外一个命令：

$ python manage.py makemigrations polls

你可以看到如下的内容：

Migrations for 'polls':
  polls/migrations/0001_initial.py:
    - Create model Choice
    - Create model Question
    - Add field question to choice

通过运行makemigrations，就是告诉Django项目模型已经有了那些修改，并且存储这些修改信息在polls/migrations/0001_initial.py文件中。

如果你想查看迁移将在数据库中执行哪些操作，可以运行命令：

$ python manage.py sqlmigrate polls 0001

你将可以看到迁移所用到的Sql语句。

注意以下几点：

• 输出的内容会根据你使用的数据库的不同而不同。
• 表明是通过合并应用名称和模型名字的小写自动生成的（如，polls_question）（可以重写）。
• 主键（id）是自动添加的（可以重写）
• 通常情况下，Django会在模型名字基础上追加“_id”作为外键字段的名字。（可以重写）
• sqlmigrate命令不在数据库上更改，仅仅是打印迁移的sql语句。

如果你感兴趣的话可以运行python manage.py check来检查你项目中的任何问题。

现在运行migrate命令在数据库里创建这些表：

$ python manage.py migrate
Operations to perform:
  Apply all migrations: admin, auth, contenttypes, polls, sessions
Running migrations:
  Rendering model states... DONE
  Applying polls.0001_initial... OK

迁移的命令是非常强大的，让你可以随时修改你的模型，而不需要删除你的数据库或表，可以很方便升级你的数据库，不会丢失数据，后面会详细介绍他们，现在你只要记住需要三步来应用模型的变化：

• 修改模型（在models.py）。
• 运行python manage.py makemigrations创建这些修改迁移。
• 运行python manage.py migrate应用这些修改到数据库。

使用API

现在，让我们进入Python shell的交互式环境并且使用Django提供的免费API。使用如下命令进入python shell：

$ python manage.py shell

这个命令是进入我们项目的shell交互环境，现在我们可以使用API来操作表：

# 创建一个问题，Django默认有日期模块，所以这儿使用timezone
>>> from django.utils import timezone
>>> q = Question(question_text=”What’s New?”,pub_date=timezone.now())
# 保存对象到数据库，你必须明确调用save()方法
>>> q.save()
# 现在你可以访问model字段的值了
>>> q.id
1
>>> q.question_text
What’s new?”
# 修改你要修改的属性，然后调用save()方法
>>> q.question_text=”What’s up?”
>>> q.save()
# 查询所有问题信息
>>> Question.objects.all()
<QuerySet [<Question: Question object>]>
# 查询投票选择
>>> q.choice_set.all()

上面的查询信息返回<QuerySet [<Question: Question object>]>，我们不知道这个对象都有什么东西，那么怎么解决这个问题呢，接下来分别在Question和Choice增加__str__方法，编辑文件polls/models.py：

from django.db import models
from django.utils.encoding import python_2_unicode_compatible

@python_2_unicode_compatible  # 如果需要支持python 2.x的话，加上这个修饰符
class Question(models.Model):
    # ...
    def __str__(self):　　　　 # 在python 2.x中，函数名为__unicode__
        return self.question_text

@python_2_unicode_compatible  # 如果需要支持python 2.x的话，加上这个修饰符
class Choice(models.Model):
    # ...
    def __str__(self):　　　　 # 在python 2.x中，函数名为__unicode__
        return self.choice_text

再次进入python shell环境，查看所有信息：

>>> Question.objects.all()
<Question: What’s up>

介绍Django管理后台

这个后台主要是方便客户或员工来管理网站内容的

创建管理员

首先我们需要创建一个可以登录到管理站点的用户，运行下面的命令：

$ python manage.py createsuperuser

按照提示输入用户名、邮箱地址、密码；现在管理员用户已经创建好了，输入命令python manage.py runserver启动开发服务器，然后在浏览器输入地址 http://127.0.0.1:8000/amdin，就可以用我们刚刚创建的用户登录系统。

将应用注册到管理系统

登录后系统我们发现，在管理界面首页并没有我创建的投票应用，那么现在我们来看一下我们的应用如何注册到管理系统，编辑文件polls/admin.py：

from django.contrib import admin

from .models import Question

admin.site.register(Question)

现在Question已经注册了，打开后台管理的首页就可以看到我们的应用：

现在你可以对Question进行管理了。

注意一下几点：

• 表单是根据Question模型，自动生成的。
• 不同的模型字段类型由相应的HTML输入组件表示。

注意：在后台管理系统设置好后，如果系统的图片都显示不出来，需要在mysite/settings.py 加入如下设置：

import mimetypes

mimetypes.add_type("image/svg+xml", ".svg", True)
mimetypes.add_type("image/svg+xml", ".svgz", True)

可能是因为系统中没有SVG媒体类型的设置。