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

让我们通过示例来学习。

在本教程中，我们将引导您完成基本投票应用程序

它将由两部分组成：

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

一、开发环境搭建

第一步当然就是安装 python，网上教程太多了，不再赘述。

第二步当然就是安装 django，直接使用

pip install django

本文使用 python 3.7.1

本文使用 django 3.2.18

二、创建项目

如果这是你第一次使用 Django 的话，你需要一些初始化设置。也就是说，你需要用一些自动生成的代码配置一个 Django project ——

即一个 Django 项目实例需要的设置项集合，包括数据库配置、Django 配置和应用程序配置。

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

django-admin startproject mysite

让我们看看 startproject 创建了什么：

mysite/

    manage.py

    mysite/

        __init__.py

        settings.py

        urls.py

        asgi.py

        wsgi.py
这些目录和文件的用处是：

外部根目录是项目的容器。其名字对姜戈来说并不重要;您可以将其重命名为您喜欢的任何名称。mysite/
manage.py：一个命令行实用程序，可让您与此交互 Django以各种方式进行项目。你可以在 django-admin 和 manage.py 中阅读所有细节。manage.py
内部目录是实际的 Python 包项目。它的名称是您需要用于导入的 Python 包名称里面的任何内容（例如）。mysite/mysite.urls
mysite/__init__.py：一个空文件，告诉 Python 这目录应被视为 Python 包。如果你是 Python 初学者，在官方 Python 文档中阅读有关包的更多信息。
mysite/settings.py：这个姜戈的设置/配置项目。Django 设置会告诉你所有关于如何设置的信息工作。
mysite/urls.py：这个 Django 项目的 URL 声明;一个 Django 驱动的网站的“目录”。您可以阅读更多 URL 调度程序中的 URL。
mysite/asgi.py：ASGI兼容Web服务器的入口点为您的项目服务。有关更多详细信息，请参阅如何使用 ASGI 进行部署。
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.

April 15, 2023 - 15:50:53

Django version 4.2, using settings 'mysite.settings'

Starting development server at http://127.0.0.1:8000/

Quit the server with CONTROL-C.

注意

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

现在服务器正在运行，请访问 http://127.0.0.1:8000/ 您的网站浏览器。你会看到一个“恭喜！”页面，火箭起飞了。成功了！

更改端口

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

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

/ 

$ python manage.py runserver 8080

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

/ 

$ python manage.py runserver 0.0.0.0:8000

开发服务器的完整文档可以在运行服务器参考中找到。

自动重新加载运行服务器

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

四、创建投票应用

现在您的环境（一个“项目”）已设置完毕，您可以开始了做工作。

你在 Django 中编写的每个应用程序都包含一个 Python 包，如下所示某种约定。Django 带有一个自动生成的实用程序应用的基本目录结构，因此您可以专注于编写代码而不是创建目录。

------------------------------------------------------

项目与应用程序

项目和应用有什么区别？应用就是网络执行某些操作的应用程序 - 例如，博客系统，数据库公共记录或小型民意调查应用程序。项目是特定网站的配置和应用程序。一个项目可以包含多个应用。一个应用可以位于多个项目中。

------------------------------------------------------

你的应用可以位于 Python 路径上的任何位置。在在本教程中，我们将在与文件相同的目录中创建我们的投票应用程序，以便它可以作为自己的顶级模块导入，而不是的子模块。manage.pymysite

若要创建应用，请确保与并键入以下命令位于同一目录中：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.shortcuts import render

from django.http import HttpResponse

def index(request):

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

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

要在轮询目录中创建 URLconf，请创建一个名为 . 您的应用目录现在应如下所示：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 指向模块。在 mysite/urls.py 中，添加导入并在列表中插入 include()，

from django.contrib import admin

from django.urls import include, path

urlpatterns = [

    path("polls/", include("polls.urls")),

    path("admin/", admin.site.urls),

]

include（） 函数允许引用其他 URLconfs。每当 Django 遇到 include（） 时，它都会砍掉任何部分 URL 匹配到该点，并将剩余的字符串发送到包含 URLconf 以供进一步处理。

您现在已经将视图连接到 URLconf 中。验证它是否适用于以下命令：index

/ 

$ python manage.py runserver

转到浏览器中的 http://localhost:8000/polls/，您应该会看到文本“你好，世界。您位于投票索引“，这是您在视图中定义的。index

path（） 函数传递了四个参数，两个必需的：和，两个可选的：和。在这一点上，值得回顾一下这些论点的用途。route,view,kwargs,name

`path（）` 参数：`route`

route是包含 URL 模式的字符串。处理请求时， Django 从第一个模式开始，然后向下发展列表，将请求的 URL 与每个模式进行比较，直到找到一个匹配。urlpatterns

模式不会搜索 GET 和 POST 参数或域名。例如在请求中，URLconf 将查找。在请求中， URLconf 也会寻找 .

https://www.example.com/myapp/myapp/

https://www.example.com/myapp/?page=3myapp/

`path（）` 参数：`view`

当 Django 找到匹配的模式时，它会调用指定的视图函数一个 HttpRequest 对象作为第一个参数和任何从路由中“捕获”值作为关键字参数。我们举个例子这有点。

`path（）` 参数：`kwargs`

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

`path（）` 参数：`name`

命名你的 URL 可以让你从 Django 的其他地方明确地引用它，尤其是从模板内部。这个强大的功能使您可以制作对项目的 URL 模式进行全局更改，同时仅接触单个文件。

----------------------------end----------------------------------