1、数据库配置
打开LWeb/settings.py。这是个包含了Django项目设置的Python模块。
通常,这个配置文件使用SQLite作为默认数据库。如果你不熟悉数据库,或者只是想尝试下Django,这是最简单的选择。Python内置SQLite。所以你无需安装额外东西来使用它。当你开始一个真正的项目时,你可能更倾向使用一个更具扩展性的数据库,例如PostgreSQL,避免中途切换数据库。
如果你想使用其他数据库,你需要安装合适的database bindings,然后改变设置文件中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等等。
SQLite以外的其它数据库
如果你使用了SQLite以外的数据库,请确认在使用前已经创建了数据库。你可以通过在你的数据库交互式命令行中使`用'CREATE DATABASE database_name;'命令来完成这件事。另外,还要确保该数据库用户中提供LWeb/settings.py具有"create database"权限。这使得自动创建的test database能被以后的教程使用。如果你使用SQLite,那么你不需要在使用前做任何事,数据库会在需要的时候自动创建。
编辑LWeb/settings.py文件前,先设置TIME_ZONE为你自己时区。
此外,关注一下文件头部的INSTALLED_APPS设置项。这里包括了会在你项目中启用的所有Django应用。应用能在多个项目中使用,你也可以打包并且发布应用,让别人使用它们。
通常,INSTALLED_APPS默认包括了以下Django的自带应用:
- django.contrib.admin:管理员站点,你很快就会使用它.
- django.contrib.auth:认证授权系统。
- django.contrib.contenttypes:内容类型框架。
- django.contrib.sessions:会话框架。
- django.contrib.messages:消息框架。
- django.contrib.staticfils:管理静态文件的框架。
这些应用被默认启用是为了给常规项目提供方便。
默认开启的某些应用需要至少一个数据表,所以在使用他们之前需要在数据库中创建一些表,请执行以下命令。
python manage.py migrate
这个migrate命令检查INSTALLED_APPS设置,为其中的每个应用创建需要的数据表,至于具体会创建什么,这取决于你的LWeb/settings.py设置文件和每个应用的数据库和迁移文件。这个命令所执行的每个迁移操作都会在终端中显示出来。如果你感兴趣的话,运行你数据库的命令行工具,并输入\dt(PostgreSQL),SHOW TABLES; (MYSQL),schema(SQLite)或者SELECT TABLE_NAME FROM USER_TABLES; (Oracle)来看看Django到底创建了哪些表。
2、创建模型
在Django里写一个数据库驱动的Web应用的第一步是定义模型,也就是数据库结构设计和附加的其他元数据。
模型是真实数据的简单明确的描述。它包含了储存的数据所必要的字段和行为。Django遵循DRY Principle。
它的目标是你只需要定义数据模型,然后其它的杂七杂八代码你都不用关心,它们会自动从模型生成。
在这个简单的投票应用中,需要创建两个模型:问题Question和选项Choice,Question模型包括问题描述和发布时间。Choice模型有两个字段,选项描述和当前得票数。每个选项属于一个问题。
这些概念可以通过一个简单的Python类来描述。按照下面的例子来编辑polls/modes.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.model.Model 类的子类。每个模型有一些类变量,它们都表示模型里的一个数据库字段。
每个字段都是 Field 类的实例 - 比如,字符字段被表示为 CharField ,日期时间字段被表示为DateTimeField 。这将告诉 Django 每个字段要处理的数据类型。
每个 Field 类实例变量的名字(例如 question_text
或 pub_date
)也是字段名,所以最好使用对机器友好的格式。你将会在 Python 代码里使用它们,而数据库会将它们作为列名。
你可以使用可选的选项来为 Field 定义一个人类可读的名字。这个功能在很多 Django 内部组成部分中都被使用了,而且作为文档的一部分。如果某个字段没有提供此名称,Django 将会使用对机器友好的名称,也就是变量名。在上面的例子中,我们只为 Question.pub_date
定义了对人类友好的名字。对于模型内的其它字段,它们的机器友好名也会被作为人类友好名使用。
定义某些 Field 类实例需要参数。例如 CharField 需要一个 max_length 参数。这个参数的用处不止于用来定义数据库结构,也用于验证数据,我们稍后将会看到这方面的内容。
Field 也能够接收多个可选参数;在上面的例子中:我们将 votes
的 default 也就是默认值,设为0。
注意在最后,我们使用 ForeignKey 定义了一个关系。这将告诉 Django,每个 Choice
对象都关联到一个 Question
对象。Django 支持所有常用的数据库关系:多对一、多对多和一对一。
3、激活模型
上面的一小段用于创建模型的代码给了Django很多信息,通过这些信息,Django可以:
- 为这个应用创建数据库schema(生成CREATE TABLE语句)。
- 创建可以与Question 和 Choice对象进行交互的Python数据库API。
但首先得把polls应用安装到我们的项目里。
为了在我们的工程中包含这个应用,我们需要在配置类INSTALLED_APPS中添加设置。因为PollsConfig类写在文件polls/apps.py中,所以它的点式路径‘polls.apps.PollsConfig’。在文件LWeb/settings.py中INSTALLED_APPS子项添加点式路径后:
INSTALLED_APPS = [
'polls.apps.PollsConfig',
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
]
现在你的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会检测你对模型文件的修改,并且把修改的部分储存为一次迁移。
迁移是Django对于模型定义(也就是你的数据库结构)的变化的储存形式。
Django有一个自动执行数据库迁移并同步管理你的数据库结构的命令,这个命令是migrate,我们马上就会接触它,但是首先,让我们看看迁移命令会执行哪些SQL语句。sqlmigrate命令接收一个迁移的名称。然后返回对应的SQL:
python manage.py sqlmigrate polls 0001
初识API
打开Python命令行:
python manage.py shell
Django管理页面:
创建一个管理员账号:
python manage.py createsuperuser
然后键入你想要使用的用户名,然后按下回车键:
Username: admin
然后提示你键入想要使用的邮件地址:
Email address:admin@example.com
最后一步输入密码:
Password: **********
Password (again): *********
Superuser created successfully.
启动服务器
启动服务器命令:
python manage.py runserver
在浏览器地址栏输入 http://127.0.0.1:8000/admin/ 进入管理员登录界面。