Django从入门到实战：编写你的第一个 Django 应用（1）

让我们通过示例来学习。我们将带着你创建一个基本的投票应用程序。

它将由两部分组成：

• 一个让人们查看和投票的公共站点。
• 一个让你能添加、修改和删除投票的管理站点。

这个示例是为了 Django 2.2 写的，它支持 Python 3.5 和后续版本。

 

创建项目

打开命令行，cd 到一个你想放置你代码的目录，然后运行以下命令：

$ django-admin startproject mywebsit

这行代码将会在当前目录下创建一个 mywebsite 目录。

注意：

你得避免使用 Python 或 Django 的内部保留字来命名你的项目。具体地说，你得避免使用像 django (会和 Django 自己产生冲突)或 test (会和 Python 的内置组件产生冲突)这样的名字。

我的代码该放在哪？

把所有 Python 代码放在 Web 服务器的根目录（var/www）不是个好主意，因为这样会有风险。比如会提高人们在网站上看到你的代码的可能性。这不利于网站的安全。

把你的代码放在文档根目录 以外 的某些地方吧，比如 /home/mycode。

如果提供了可选目标，Django将使用该现有目录作为项目目录，并在其中创建manage.py项目包。使用 '。' 表示当前的工作目录。

例如：

django-admin startproject myproject /home/mycode

让我们看看 startproject 创建了些什么:

mywebsite/           #项目的容器， Django 不关心它的名字，你可以将它重命名为任何你喜欢的名字。
    manage.py        # 一个让你用各种方式管理 Django 项目的命令行工具。
    mywebsite/       # 里面一层的 mywebsite/目录包含你的项目，它是一个纯 Python 包。
        __init__.py   #一个空文件，告诉 Python 这个目录应该被认为是一个 Python 包。
        settings.py   #Django 项目的配置文件
        urls.py          #Django 项目的 URL 声明，就像你网站的“目录”。
        wsgi.py         #作为你的项目的运行在 WSGI 兼容的Web服务器上的入口。

 

用于开发的简易服务器

让我们来确认一下你的 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.

五月 24, 2019 - 15:50:53
Django version 2.2, 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 服务器方面并不是。)

现在，服务器正在运行，浏览器访问 https://127.0.0.1:8000。你将会看到一个“祝贺”页面，随着一只火箭发射，服务器已经运行了。

更换端口

默认情况下，runserver命令会将服务器设置为监听本机内部 IP 的 8000 端口。

如果你想更换服务器的监听端口，请使用命令行参数。举个例子，下面的命令会使服务器监听 8080 端口：

$ python manage.py runserver 8080

如果你想要修改服务器监听的IP，在端口之前输入新的。比如，为了监听所有服务器的公开IP（这你运行 Vagrant 或想要向网络上的其它电脑展示你的成果时很有用），使用：

$ python manage.py runserver 0:8000

0 是 0.0.0.0 的简写。

会自动重新加载的服务器 runserver

用于开发的服务器在需要的情况下会对每一次的访问请求重新载入一遍 Python 代码。所以你不需要为了让修改的代码生效而频繁的重新启动服务器。然而，一些动作，比如添加新文件，将不会触发自动重新加载，这时你得自己手动重启服务器。

创建投票应用

现在“项目”已经配置好了，在 Django 中，每一个应用都是一个 Python 包，并且遵循着相同的约定。Django 自带一个工具，可以帮你生成应用的基础目录结构，这样你就能专心写代码，而不是创建目录了。

项目 VS 应用

项目和应用有啥区别？应用是一个专门做某件事的网络应用程序——比如博客系统，或者公共记录的数据库，或者简单的投票程序。项目则是一个网站使用的配置和应用的集合。项目可以包含很多个应用。应用可以被很多个项目使用。

你的应用可以存放在任何 Python path 中定义的路径。我们将在你的 manage.py 同级目录下创建投票应用。这样它就可以作为顶级模块导入，而不是 mywebsite（项目Python包） 的子模块。

请确定你现在处于 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 代码输入进去：

#polls/views.py
from django.http import HttpResponse

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

这是 Django 中最简单的视图。如果想看见效果，我们需要将一个 URL 映射到它——这就是我们需要 URLconf 的原因了。

为了创建 URLconf，请在 polls （项目应用）目录里新建一个 urls.py 文件。你的应用目录现在看起来应该是这样：

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

在 polls/urls.py 中，输入如下代码：

#polls/urls.py

from django.urls import path

from . import views

urlpatterns = [
    path('', views.index, name='index'),
]

下一步是要在根 URLconf 文件中指定我们创建的 polls.urls 模块。在 mywebsite/urls.py 文件的 urlpatterns 列表里插入一个 include()， 如下：

#mywebsite/urls.py

from django.contrib import admin
from django.urls import include, path

urlpatterns = [
    path('polls/', include('polls.urls')),
    path('admin/', admin.site.urls),
]

 

用你的浏览器访问 https://127.0.0.0.1:8000/polls/，你应该能够看见 "Hello, world. You're at the polls index." ，这是你在 index 视图中定义的。

没有找到页面?

如果你在这里得到了一个错误页面，检查一下你是不是正访问着http://127.0.0.0.1:8000/polls/ 而不应该是 http://127.0.0.0.1:8000/。

函数 include()

函数include() 允许引用其它 URLconfs。每当 Django 遇到函数django.urls.include 时，它会截断与此项匹配的 URL 的部分，并将剩余的字符串发送到 URLconf 以供进一步处理。

我们设计 include() 的理念是使其可以即插即用。因为投票应用有它自己的 URLconf( polls/urls.py )，他们能够被放在 "/polls/" ， "/fun_polls/" ，"/content/polls/"，或者其他任何路径下，这个应用都能够正常工作。

何时使用 include()

当包括其它 URL 模式时你应该总是使用 include() ， admin.site.urls 是唯一例外。

你现在把 index 视图添加进了 URLconf。通过以下命令验证是否正常工作：

$ python manage.py runserver

 

函数 path（）

函数 path（）具有四个参数，两个必须参数：route 和 view，两个可选参数：kwargs 和 name。现在，是时候来研究这些参数的含义了。

• path（） 参数： route 是一个匹配 URL 的准则（类似正则表达式）。当 Django 响应一个请求时，它会从 urlpatterns 的第一项开始，按顺序依次匹配列表中的项，直到找到匹配的项。这些准则不会匹配 GET 和 POST 参数或域名。例如，URLconf 在处理请求 https://www.example.com/myapp/ 时，它会尝试匹配 myapp/ 。处理请求 https://www.example.com/myapp/?page=3 时，也只会尝试匹配 myapp/。
• path（）参数： view是当 Django 找到了一个匹配的准则，就会调用这个特定的视图函数，并传入一个 HttpRequest 对象作为第一个参数，被“捕获”的参数以关键字参数的形式传入。稍后，我们会给出一个例子。
• path（） 参数： kwargs是任意个关键字参数可以作为一个字典传递给目标视图函数。本教程中不会使用这一特性。
• path（） 参数： name是为你的 URL 取名能使你在 Django 的任意地方唯一地引用它，尤其是在模板中。这个有用的特性允许你只改一个文件就能全局地修改某个 URL 模式。

当你了解了基本的请求和响应流程后，然后开始使用数据库，下篇博客见了。

 

写在最后，欢迎关注一个跨行学python人的微信公众号：大众学python

掏出手机扫一扫：