第一个 Django 工程搭建

阳光穿透心脏的1/2处 2022-10-29 03:23 176阅读 0赞

> Django是当前最出色基于Python的Web应用开发平台之一，本文对其进行简要介绍并创建一个空的Django工程。

### 前后端 ###

*  Web开发的目的可以说是为用户提供一个可以获取信息或交互的服务场景，这其中涉及到几个重要的模块：显示模块、业务处理模块和数据存储模块。

服务器

显示

交互

数据交互

解析请求

生成html页面

业务处理

浏览器

数据库

*  大框架就是用户向服务器提出服务请求，服务器接收请求从数据库中提取数据，送入处理模块处理后得到用户需要的内容，再经过显示模块将内容展现在用户面前。
 *  这个过程中，当前把数据处理、业务处理的部分称为后端，向用户展示内容与设计和用户、后端的交互逻辑的部分称为前端。
 *  为了解耦业务处理与界面显示，经过前辈多年开发经历，当前最佳实践为前后端分离，使得前端人员和后端人员约定好接口进行交互，之后前端只需要把界面做好，后端只需要做好业务逻辑处理。

### Django ###

#### 简介 ####

> Django 是一个开放源代码的 Web 应用框架，由 Python 写成，其主要目的是简便、快速的开发数据库驱动的网站。它强调代码复用，多个组件可以很方便的以“插件”形式服务于整个框架，Django有许多功能强大的第三方插件，你甚至可以很方便的开发出自己的工具包。

*  项目源码：https://github.com/django/django
 *  官网：https://www.djangoproject.com/
 *  Django中文网：https://www.django.cn/

#### 版本 ####

> Django 开发组无比勤奋，版本计划很紧凑，迭代很频繁

<table> 
 <thead> 
  <tr> 
   <th>Release Series</th> 
   <th>Latest Release</th> 
   <th>End of mainstream support<a href="https://www.djangoproject.com/download/#ft1" rel="nofollow">1</a></th> 
   <th>End of extended support<a href="https://www.djangoproject.com/download/#ft2" rel="nofollow">2</a></th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>4.2 LTS</td> 
   <td>April 2023</td> 
   <td>December 2023</td> 
   <td>April 2026</td> 
  </tr> 
  <tr> 
   <td>4.1</td> 
   <td>August 2022</td> 
   <td>April 2023</td> 
   <td>December 2023</td> 
  </tr> 
  <tr> 
   <td>4.0</td> 
   <td>December 2021</td> 
   <td>August 2022</td> 
   <td>April 2023</td> 
  </tr> 
  <tr> 
   <td>3.2 LTS</td> 
   <td>April 2021</td> 
   <td>December 2021</td> 
   <td>April 2024</td> 
  </tr> 
  <tr> 
   <td>3.1</td> 
   <td>3.1.5</td> 
   <td>April 2021</td> 
   <td>December 2021</td> 
  </tr> 
  <tr> 
   <td>3.0</td> 
   <td>3.0.11</td> 
   <td>August, 2020</td> 
   <td>April, 2021</td> 
  </tr> 
  <tr> 
   <td>2.2 LTS</td> 
   <td>2.2.17</td> 
   <td>December 2, 2019</td> 
   <td>April 2022</td> 
  </tr> 
  <tr> 
   <td>2.1</td> 
   <td>2.1.15</td> 
   <td>April 1, 2019</td> 
   <td>December 2, 2019</td> 
  </tr> 
  <tr> 
   <td>2.0</td> 
   <td>2.0.13</td> 
   <td>August 1, 2018</td> 
   <td>April 1, 2019</td> 
  </tr> 
  <tr> 
   <td>1.11 LTS <a href="https://www.djangoproject.com/download/#ft3" rel="nofollow">3</a></td> 
   <td>1.11.29</td> 
   <td>December 2, 2017</td> 
   <td>April 1, 2020</td> 
  </tr> 
  <tr> 
   <td>1.10</td> 
   <td>1.10.8</td> 
   <td>April 4, 2017</td> 
   <td>December 2, 2017</td> 
  </tr> 
  <tr> 
   <td>1.9</td> 
   <td>1.9.13</td> 
   <td>August 1, 2016</td> 
   <td>April 4, 2017</td> 
  </tr> 
  <tr> 
   <td>1.8 LTS</td> 
   <td>1.8.19</td> 
   <td>December 1, 2015</td> 
   <td>April 1, 2018</td> 
  </tr> 
  <tr> 
   <td>1.7</td> 
   <td>1.7.11</td> 
   <td>April 1, 2015</td> 
   <td>December 1, 2015</td> 
  </tr> 
  <tr> 
   <td>1.6</td> 
   <td>1.6.11</td> 
   <td>September 2, 2014</td> 
   <td>April 1, 2015</td> 
  </tr> 
  <tr> 
   <td>1.5</td> 
   <td>1.5.12</td> 
   <td>November 6, 2013</td> 
   <td>September 2, 2014</td> 
  </tr> 
  <tr> 
   <td>1.4 LTS</td> 
   <td>1.4.22</td> 
   <td>February 26, 2013</td> 
   <td>October 1, 2015</td> 
  </tr> 
  <tr> 
   <td>1.3</td> 
   <td>1.3.7</td> 
   <td>March 23, 2012</td> 
   <td>February 26, 2013</td> 
  </tr> 
 </tbody> 
</table>

\[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-2BFbSEuB-1612752622308)(https://photos.zywvvd.com/icey-mate-book/20210123141536.png)\]

*  Django基于Python开发，并且基于Python环境运行，不同Django版本对Python版本有不同的需求：

<table> 
 <thead> 
  <tr> 
   <th align="left">Django 版本</th> 
   <th align="left">Python 版本</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">1.8</td> 
   <td align="left">2.7, 3.2 (until the end of 2016), 3.3, 3.4, 3.5</td> 
  </tr> 
  <tr> 
   <td align="left">1.9, 1.10</td> 
   <td align="left">2.7, 3.4, 3.5</td> 
  </tr> 
  <tr> 
   <td align="left">1.11</td> 
   <td align="left">2.7，3.4，3.5，3.6，3.7 (1.11.17添加)</td> 
  </tr> 
  <tr> 
   <td align="left">2.0</td> 
   <td align="left">3.4，3.5，3.6，3.7</td> 
  </tr> 
  <tr> 
   <td align="left">2.1，2.2</td> 
   <td align="left">3.5, 3.6, 3.7</td> 
  </tr> 
  <tr> 
   <td align="left">3.0</td> 
   <td align="left">3.6, 3.7, 3.8</td> 
  </tr> 
  <tr> 
   <td align="left">3.1</td> 
   <td align="left">3.6, 3.7, 3.8 or later</td> 
  </tr> 
 </tbody> 
</table>

#### 安装 ####

*  确定自己需要的Django版本，当前（2021年1月23日）最新的Django版本为3.1.5，我的python版本3.8.3
 *  使用pip安装：

pip install Django

> 此时pip默认按装的是3.0.5版本

*  如果需要最新版本可以指定：

pip install Django==3.1.5

*  安装官网：https://www.djangoproject.com/download/
 *  安装后可以使用 `pip show`命令查看包信息：

pip show django
    
    -->
    Name: Django
    Version: 3.0.5
    Summary: A high-level Python Web framework that encourages rapid development and clean, pragmatic design.
    Home-page: https://www.djangoproject.com/
    Author: Django Software Foundation
    Author-email: foundation@djangoproject.com
    License: BSD
    Location: d:\program_files\anaconda3\lib\site-packages
    Requires: pytz, asgiref, sqlparse

或

python -m django --version
    
    -->
    3.0.5

### 项目创建 ###

*  找好一个存放Django工程的文件夹，在此处打开终端，键入命令：

> 假设我们想要创建名为 `vvd_django` 的工程：

django-admin startproject vvd_django

*  当前项目的目录结构：

tree /F  # windows
    tree -a  # Linux
    
    -->
    └─vvd_django
        │  manage.py
        └─vvd_django
                asgi.py
                settings.py
                urls.py
                wsgi.py
                __init__.py

*  这些目录和文件的用处是：
    
     *  最外层的 `vvd_django/` 根目录只是你项目的容器， 根目录名称对Django没有影响，你可以将它重命名为任何你喜欢的名称。
     *  `manage.py`: 一个让你用各种方式管理 Django 项目的命令行工具。你可以阅读 [django-admin and manage.py][] 获取所有 `manage.py` 的细节。
     *  里面一层的 `vvd_django/` 目录包含你的项目，它是一个纯 Python 包。它的名字就是当你引用它内部任何东西时需要用到的 Python 包名。 (比如 `vvd_django.urls`).
     *  `vvd_django/__init__.py`：一个空文件，告诉 Python 这个目录应该被认为是一个 Python 包。如果你是 Python 初学者，阅读官方文档中的 [更多关于包的知识][Link 1]。
     *  `vvd_django/settings.py`：Django 项目的配置文件。如果你想知道这个文件是如何工作的，请查看 [Django 配置][Django] 了解细节。
     *  `vvd_django/urls.py`：Django 项目的 URL 声明，就像你网站的“目录”。阅读 [URL调度器][URL] 文档来获取更多关于 URL 的内容。
     *  `vvd_django/asgi.py`：作为你的项目的运行在 ASGI 兼容的Web服务器上的入口。阅读 [如何使用 WSGI 进行部署][WSGI] 了解更多细节。
     *  `vvd_django/wsgi.py`：作为你的项目的运行在 WSGI 兼容的Web服务器上的入口。阅读 [如何使用 WSGI 进行部署][WSGI] 了解更多细节。
     *  同步数据库文件：

> Django默认数据库为db.sqlite3

cd vvd_django
    python manage.py migrate
    
    -->
    Operations to perform:
      Apply all migrations: admin, auth, contenttypes, sessions
    Running migrations:
      Applying contenttypes.0001_initial... OK
      Applying auth.0001_initial... OK
      Applying admin.0001_initial... OK
      Applying admin.0002_logentry_remove_auto_add... OK
      Applying admin.0003_logentry_add_action_flag_choices... OK
      Applying contenttypes.0002_remove_content_type_name... OK
      Applying auth.0002_alter_permission_name_max_length... OK
      Applying auth.0003_alter_user_email_max_length... OK
      Applying auth.0004_alter_user_username_opts... OK
      Applying auth.0005_alter_user_last_login_null... OK
      Applying auth.0006_require_contenttypes_0002... OK
      Applying auth.0007_alter_validators_add_error_messages... OK
      Applying auth.0008_alter_user_username_max_length... OK
      Applying auth.0009_alter_user_last_name_max_length... OK
      Applying auth.0010_alter_group_name_max_length... OK
      Applying auth.0011_update_proxy_permissions... OK
      Applying sessions.0001_initial... OK

*  启动Django Server ，检查我们当前的项目状态：

python manage.py runserver
    
    -->
    Watching for file changes with StatReloader
    Performing system checks...
    
    System check identified no issues (0 silenced).
    January 23, 2021 - 15:42:03
    Django version 3.0.5, using settings 'vvd_django.settings'
    Starting development server at http://127.0.0.1:8000/
    Quit the server with CTRL-BREAK.

*  此时我们使用浏览器访问 http://127.0.0.1:8000/

![5d7316b5290cecdb08259c67f90a77bd.png][]

> 出现小火箭说明我们的第一个Django工程正常运作。

### 编写第一个视图 ###

#### 新建应用 ####

*  在工程根目录终端运行：

python manage.py startapp hello_world

*  当前项目文件结构

│  db.sqlite3
    │  manage.py
    ├─hello_world
    │  │  admin.py
    │  │  apps.py
    │  │  models.py
    │  │  tests.py
    │  │  views.py
    │  │  __init__.py
    │  └─migrations
    │          __init__.py
    └─vvd_django
        │  asgi.py
        │  settings.py
        │  urls.py
        │  wsgi.py
        └─ __init__.py

#### 新建视图 ####

> 打开 `hello_world/views.py`，把下面这些 Python 代码输入进去：

from django.shortcuts import render
    # Create your views here.
    from django.http import HttpResponse
    
    
    def index(request):
        return HttpResponse("Hello, world. You're at the vvd hello_world index.")

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

#### 应用url映射 ####

*  在 `hello_world`目录里新建一个 `urls.py` 文件，并输入代码：

from django.urls import path
    
    from . import views
    
    urlpatterns = [
        path('', views.index, name='index'),
    ]

#### 根url映射 ####

*  在根 URLconf 文件中指定我们创建的 `hello_world.urls` 模块。在 `vvd_django/urls.py` 文件的 `urlpatterns` 列表里插入一个 `include()`， 如下：

from django.contrib import admin
    from django.urls import include, path
    
    urlpatterns = [
        path('hello_world/', include('hello_world.urls')),
        path('admin/', admin.site.urls),
    ]

> 函数 [`include()`][include] 允许引用其它 URLconfs, 它的理念是使其可以即插即用。每当 Django 遇到 [`include()`][include] 时，它会截断与此项匹配的 URL 的部分，并将剩余的字符串发送到 URLconf 以供进一步处理。他们能够被放在任何路径下，使得应用都能够正常工作。

#### 运行服务 ####

python manage.py runserver

#### 访问应用 ####

*  此时我们访问我们建立的 `serever/hello_world`链接——http://localhost:8000/hello\_world/

![7288aee1f26c60c903f33c1388e64770.png][]

*  表明我们的应用被成功调用

### 参考资料 ###

*  https://github.com/django/django
 *  https://www.djangoproject.com/
 *  https://www.django.cn/
 *  https://docs.djangoproject.com/zh-hans/3.0/intro/tutorial01/
 *  https://blog.csdn.net/weixin\_41666747/article/details/104026496

[django-admin and manage.py]: https://docs.djangoproject.com/zh-hans/3.0/ref/django-admin/
[Link 1]: https://docs.python.org/3/tutorial/modules.html#tut-packages
[Django]: https://docs.djangoproject.com/zh-hans/3.0/topics/settings/
[URL]: https://docs.djangoproject.com/zh-hans/3.0/topics/http/urls/
[WSGI]: https://docs.djangoproject.com/zh-hans/3.0/howto/deployment/wsgi/
[5d7316b5290cecdb08259c67f90a77bd.png]: /images/20221024/35bd7513476542b89d08989aba27cf67.png
[include]: https://docs.djangoproject.com/zh-hans/3.0/ref/urls/#django.urls.include
[7288aee1f26c60c903f33c1388e64770.png]: /images/20221024/f74ee007addc4e8eb91dd5e43a1b88d0.png