>>>

设置数据库¶

只有在您希望使用PostgreSQL，MySQL或Oracle等“大型”数据库引擎时，才需要执行此步骤。要安装此类数据库，请查阅数据库安装信息。

删除任何旧版本的Django¶

如果要从先前版本升级Django的安装，则需要在安装新版本之前卸载旧的Django版本。

安装Django¶

你有三个简单的选项来安装Django：

安装正式版。这是大多数用户的最佳方法。
安装操作系统分发版提供的Django版本。
安装最新的开发版本。此选项适用于需要最新和最强大功能并且不怕运行全新代码的发烧友。您可能会在开发版本中遇到新的错误，但报告它们有助于Django的开发。此外，与最新的稳定版本相比，第三方软件包的发行版不太可能与开发版本兼容。

请始终参考与您正在使用的Django版本对应的文档！

如果您执行前两个步骤中的任何一个，请留意开发版本中标记为新文档的部分文档。该短语标记仅在Django的开发版本中可用的功能，并且它们可能不适用于正式版本。

验证¶

要验证Python可以看到Django，请python从shell中输入。然后在Python提示符下，尝试导入Django：

>>> import django
>>> print(django.get_version())
1.11

编写你的第一个Django应用程序，第1部分¶

让我们通过例子来学习。

在本教程中，我们将引导您完成基本轮询应用程序的创建。

它由两部分组成：

一个公共站点，允许人们查看民意调查并在其中投票。
一个管理站点，允许您添加，更改和删除民意调查。

我们假设你已经安装了Django。您可以通过在shell提示符中运行以下命令（由$前缀表示）来告知Django已安装以及哪个版本：

$ python -m django --version

如果安装了Django，您应该会看到安装的版本。如果不是，您将收到错误消息“没有名为django的模块”。

本教程是为Django 1.11和Python 3.4或更高版本编写的。如果Django版本不匹配，您可以使用本页右下角的版本切换器参考您的Django版本的教程，或者将Django更新到最新版本。如果您仍在使用Python 2.7，则需要稍微调整代码示例，如注释中所述。

有关如何删除旧版本Django并安装较新版本的建议，请参阅如何安装Django。

创建项目¶

如果这是你第一次使用Django，你将不得不处理一些初始设置。也就是说，您需要自动生成一些建立Django 项目的代码- Django实例的设置集合，包括数据库配置，Django特定选项和特定于应用程序的设置。

从命令行cd进入要存储代码的目录，然后运行以下命令：

$ django-admin startproject mysite

这将mysite在当前目录中创建一个目录。如果它不起作用，请参阅运行django-admin的问题。

注意

您需要避免在内置Python或Django组件之后命名项目。特别是，这意味着你应该避免使用像 django（这将与Django本身冲突）或test（与内置Python包冲突）这样的名称。

这段代码应该在哪里生活？

如果您的背景是普通的PHP（不使用现代框架），那么您可能习惯将代码放在Web服务器的文档根目录下（在某个地方/var/www）。使用Django，你不会这样做。将任何此Python代码放在Web服务器的文档根目录中并不是一个好主意，因为它可能会使人们可能通过Web查看您的代码。这对安全性不利。

将代码放在文档根目录之外的某个目录中，例如 /home/mycode。

让我们来看看startproject创造了什么：

mysite/
    manage.py
    mysite/
        __init__.py
        settings.py
        urls.py
        wsgi.py

这些文件是：

外部mysite/根目录只是项目的容器。它的名字对Django来说无关紧要; 你可以将它重命名为你喜欢的任何东西。
manage.py：一个命令行实用程序，允许您以各种方式与此Django项目进行交互。您可以manage.py在django-admin和manage.py中阅读有关的所有详细信息。
内部mysite/目录是项目的实际Python包。它的名称是您需要用来导入其中任何内容的Python包名称（例如mysite.urls）。
mysite/__init__.py：一个空文件，告诉Python该目录应该被视为Python包。如果您是Python初学者，请阅读官方Python文档中有关包的更多信息。
mysite/settings.py：此Django项目的设置/配置。 Django设置将告诉您有关设置如何工作的所有信息。
mysite/urls.py：这个Django项目的URL声明; 您的Django支持的站点的“目录”。您可以在URL调度程序中阅读有关URL的更多信息。
mysite/wsgi.py：与WSGI兼容的Web服务器的入口点，用于为您的项目提供服务。有关更多详细信息，请参阅如何使用WSGI进行部署。

开发服务器¶

让我们验证您的Django项目是否有效。mysite如果尚未更改到外部目录，请运行以下命令：

$ python manage.py runserver

您将在命令行中看到以下输出：

Performing system checks...

System check identified no issues (0 silenced).

You have unapplied migrations; your app may not work properly until they are applied.
Run \'python manage.py migrate\' to apply them.

December 05, 2018 - 15:50:53
Django version 1.11, using settings \'mysite.settings\'
Starting development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.

注意

暂时忽略有关未应用数据库迁移的警告; 我们很快就会处理数据库。

您已经启动了Django开发服务器，这是一个纯粹用Python编写的轻量级Web服务器。我们已经将它包含在Django中，因此您可以快速开发，而无需处理配置生产服务器（如Apache），直到您准备好进行生产。

现在是时候注意了：不要在类似生产环境的任何地方使用这个服务器。它仅用于开发时使用。（我们的业务是制作Web框架，而不是Web服务器。）

现在服务器正在运行，请使用Web浏览器访问http://127.0.0.1:8000/。您将看到一个“欢迎来到Django”页面，采用令人愉悦的浅蓝色粉彩。有效！

改变端口

默认情况下，该runserver命令在端口8000的内部IP上启动开发服务器。

如果要更改服务器的端口，请将其作为命令行参数传递。例如，此命令在端口8080上启动服务器：

$ python manage.py runserver 8080

如果要更改服务器的IP，请将其与端口一起传递。例如，要监听所有可用的公共IP（如果您正在运行Vagrant或想要在网络上的其他计算机上展示您的工作，这很有用），请使用：

$ python manage.py runserver 0:8000

0是0.0.0.0的快捷方式。可以在runserver参考中找到开发服务器的完整文档。

自动重装 runserver

开发服务器根据需要自动为每个请求重新加载Python代码。您无需重新启动服务器即可使代码更改生效。但是，某些操作（如添加文件）不会触发重新启动，因此在这些情况下您必须重新启动服务器。

创建民意调查应用¶

既然你的环境 - 一个“项目” - 已经建立起来，你就可以开始工作了。

您在Django中编写的每个应用程序都包含一个遵循特定约定的Python包。Django附带了一个实用程序，可以自动生成应用程序的基本目录结构，因此您可以专注于编写代码而不是创建目录。

项目与应用

项目和应用程序之间有什么区别？应用程序是执行某些操作的Web应用程序 - 例如，Weblog系统，公共记录数据库或简单的轮询应用程序。项目是特定网站的配置和应用程序的集合。项目可以包含多个应用程序。一个应用程序可以在多个项目中。

您的应用程序可以存在于Python路径的任何位置。在本教程中，我们将在您的manage.py 文件旁边创建我们的民意调查应用程序，以便可以将其导入为自己的顶级模块，而不是子模块mysite。

要创建应用程序，请确保您与该目录位于同一目录中manage.py 并键入以下命令：

$ python manage.py startapp polls

那将创建一个目录polls，其布局如下：

polls/
    __init__.py
    admin.py
    apps.py
    migrations/
        __init__.py
    models.py
    tests.py
    views.py

此目录结构将容纳轮询应用程序。

写下你的第一个视图¶

我们来写第一个视图。打开文件polls/views.py 并在其中放入以下Python代码：

from django.http import HttpResponse


def index(request):
    return HttpResponse(\"Hello, world. You\'re at the polls index.\")

这是Django中最简单的视图。要调用视图，我们需要将其映射到URL - 为此我们需要一个URLconf。

要在polls目录中创建URLconf，请创建一个名为的文件urls.py。您的app目录现在应该如下所示：

polls/
    __init__.py
    admin.py
    apps.py
    migrations/
        __init__.py
    models.py
    tests.py
    urls.py
    views.py

在该polls/urls.py文件中包含以下代码：

$\"\"$ $\"\"$

from django.conf.urls import url

from . import views

urlpatterns = [
    url(r\'^$\', views.index, name=\'index\'),
]

polls/urls.py

下一步是将根URLconf指向polls.urls模块。在 mysite/urls.py，添加导入django.conf.urls.include并include()在urlpatterns列表中插入，所以你有：

$\"\"$ $\"\"$

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

urlpatterns = [
    url(r\'^polls/\', include(\'polls.urls\')),
    url(r\'^admin/\', admin.site.urls),
]

mysite/urls.py

该include()函数允许引用其他URLconf。请注意，该include()函数的正则表达式没有$（字符串结尾匹配字符），而是一个尾部斜杠。每当Django遇到时 include()，它都会删除与该点匹配的URL的任何部分，并将剩余的字符串发送到包含的URLconf以进行进一步处理。

背后的想法include()是使即插即用的URL变得容易。由于民意调查位于他们自己的URLconf（polls/urls.py）中，因此可以将它们放在“/ polls /”下，或“/ fun_polls /”下，或“/ content / polls /”下，或任何其他路径根目录下，并且应用程序仍然可以工作。

什么时候用 include()

include()当您包含其他URL模式时，应始终使用。 admin.site.urls是唯一的例外。

与你看到的不符？

如果您看到的include(admin.site.urls)不是公正的 admin.site.urls，那么您可能正在使用与本教程版本不匹配的Django版本。您将要切换到较旧的教程或较新的Django版本。

您现在已将index视图连接到URLconf。让我们验证它是否正常工作，运行以下命令：

$ python manage.py runserver

在浏览器中转到http：// localhost：8000 / polls /，您应该看到文本“ Hello，world。. You’re at the polls index.”, 您在index视图中定义的。

该url()函数传递了四个参数，两个必需：regex和view，以及两个可选：kwargs，和name。在这一点上，值得回顾一下这些论点的用途。

`url()`参数：正则表达式¶

术语“正则表达式”是一种常用的缩写形式，意思是“正则表达式”，它是用于匹配字符串中的模式的语法，或者在这种情况下是url模式。Django从第一个正则表达式开始，沿着列表向下，将请求的URL与每个正则表达式进行比较，直到找到匹配的正则表达式。

请注意，这些正则表达式不会搜索GET和POST参数或域名。例如，在请求中 https://www.example.com/myapp/，URLconf将查找myapp/。在请求中https://www.example.com/myapp/?page=3，URLconf也会查找myapp/。

如果您需要有关正则表达式的帮助，请参阅Wikipedia的条目和re模块的文档。另外，杰弗里·弗里德（Jeffrey Friedl）的奥莱利（O\'Reilly）着作“掌握正则表达式”（Mastering Regular s 但是，在实践中，您不需要成为正则表达式的专家，因为您实际上只需要知道如何捕获简单模式。事实上，复杂的正则表达式可能具有较差的查找性能，因此您可能不应该依赖于正则表达式的全部功能。

最后，一个性能说明：这些正则表达式是在第一次加载URLconf模块时编译的。它们超快（只要查找不是太复杂，如上所述）。

`url()`参数：视图¶

当Django找到正则表达式匹配时，Django调用指定的视图函数，将HttpRequest对象作为第一个参数，将正则表达式中的任何“捕获”值作为其他参数。如果正则表达式使用简单捕获，则值将作为位置参数传递; 如果它使用命名捕获，则值将作为关键字参数传递。我们稍后会给出一个例子。

`url()`参数：kwargs ¶

任意关键字参数可以在字典中传递到目标视图。我们不打算在教程中使用Django的这个功能。

`url()`参数：名称¶

命名您的URL可让您从Django的其他地方明确地引用它，尤其是在模板中。此强大功能允许您在仅触摸单个文件的同时对项目的URL模式进行全局更改。

编写你的第一个Django应用程序，第2部分¶

本教程从教程1停止的地方开始。我们将设置数据库，创建您的第一个模型，并快速介绍Django自动生成的管理站点。

数据库设置¶

现在，打开mysite/settings.py。这是一个普通的Python模块，其中模块级变量代表Django设置。

默认情况下，配置使用SQLite。如果您是数据库新手，或者您只是想尝试Django，这是最简单的选择。SQLite包含在Python中，因此您无需安装任何其他东西来支持您的数据库。但是，在启动第一个真正的项目时，您可能希望使用像PostgreSQL这样的更具伸缩性的数据库，以避免数据库切换问题。

如果要使用其他数据库，请安装相应的数据库绑定并更改项目中的以下键以匹配数据库连接设置：DATA S \'default\'

ENGINE-要么 \'django.db.backends.sqlite3\'， \'django.db.backends.postgresql\'， \'django.db.backends.mysql\'，或\'django.db.backends.oracle\'。其他后端也可用。
NAME - 数据库的名称。如果您使用的是SQLite，则数据库将是您计算机上的文件; 在这种情况下，NAME 应该是该文件的完整绝对路径，包括文件名。默认值,, 将文件存储在项目目录中。os.path.join( _DIR, \'db.sqlite3\')

如果你不使用SQLite作为数据库，额外的设置，例如 USER，PASSWORD和HOST必须加入。有关更多详细信息，请参阅参考文档DATA S。

对于SQLite以外的数据库

如果您使用的是除SQLite之外的数据库，请确保此时已创建数据库。在数据库的交互式提示中使用“ ” 执行此操作。CREATEDATA data _name;

还要确保提供的数据库用户mysite/settings.py 具有“create data ”特权。这允许自动创建测试数据库，这将在以后的教程中使用。

如果您使用的是SQLite，则无需事先创建任何内容 - 数据库文件将在需要时自动创建。

在编辑时mysite/settings.py，请设置TIME_ZONE为您的时区。

另外，请注意INSTALLED_APPS文件顶部的设置。它包含在这个Django实例中激活的所有Django应用程序的名称。应用程序可以在多个项目中使用，您可以打包和分发它们以供项目中的其他人使用。

默认情况下，INSTALLED_APPS包含以下应用程序，所有这些应用程序都随Django一起提供：

django.contrib.admin - 管理站点。你很快就会用到它。
django.contrib.auth - 认证系统。
django.contrib.contenttypes - 内容类型的框架。
django.contrib.sessions - 会话框架。
django.contrib.messages - 消息传递框架。
django.contrib.staticfiles - 用于管理静态文件的框架。

默认情况下包含这些应用程序，以方便常见情况。

但是，其中一些应用程序至少使用了一个数据库表，因此我们需要先在数据库中创建表，然后才能使用它们。为此，请运行以下命令：

$ python manage.py migrate

该migrate命令查看INSTALLED_APPS设置并根据mysite/settings.py文件中的数据库设置和应用程序附带的数据库迁移创建任何必要的数据库表（稍后我们将介绍这些表）。您将看到适用于每次迁移的消息。如果您有兴趣，请运行数据库的命令行客户端并键入\\dt（PostgreSQL），（MySQL），（SQLite）或（Oracle）以显示Django创建的表。SHOW TABLES;.schemaSELECT TABLE_NAME FROMUSER_TABLES;

对于极简主义者

就像我们上面所说的那样，默认应用程序包含在常见情况中，但不是每个人都需要它们。如果您不需要其中任何一个或全部，请INSTALLED_APPS在运行前随意注释或删除相应的行 migrate。该 migrate命令仅运行应用程序的迁移INSTALLED_APPS。

创建模型¶

现在我们将定义您的模型 - 本质上是您的数据库布局，以及其他元数据。

哲学

模型是关于数据的单一，明确的真实来源。它包含您要存储的数据的基本字段和行为。Django遵循DRY原则。目标是在一个地方定义您的数据模型，并自动从中获取数据。

这包括迁移 - 与Ruby On Rails不同，例如，迁移完全来自您的模型文件，并且基本上只是Django可以通过更新数据库模式以匹配您当前模型的历史记录。

在我们简单的民意调查应用程序中，我们将创建两个模型：Question和Choice。A Question有问题和出版日期。A 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)

polls/models.py

代码很简单。每个模型由一个子类表示django.db.models.Model。每个模型都有许多类变量，每个变量代表模型中的数据库字段。

每个字段由Field 类的实例表示- 例如，CharField用于字符字段和 DateTimeField日期时间。这告诉Django每个字段包含哪种类型的数据。

每个Field实例的名称（例如 question_text或pub_date）是字段名称，采用机器友好格式。您将在Python代码中使用此值，并且您的数据库将使用它作为列名。

您可以使用可选的第一个位置参数 Field来指定一个人类可读的名称。这在Django的几个内省部分中使用，并且它兼作文档。如果未提供此字段，Django将使用机器可读的名称。在这个例子中，我们只定义了一个人类可读的名称Question.pub_date。对于此模型中的所有其他字段，字段的机器可读名称就足以作为其可读的名称。

有些Field类需要参数。 CharField例如，要求你给它一个 max_length。这不仅在数据库模式中使用，而且在验证中使用，我们很快就会看到。

A Field也可以有各种可选参数; 在这种情况下，我们将default值设置votes为0。

最后，请注意使用的定义关系 ForeignKey。这告诉Django每个Choice都与单个相关Question。Django支持所有常见的数据库关系：多对一，多对多和一对一。