django 3.0

刺骨的言语ヽ痛彻心扉 2023-07-17 15:48 1阅读 0赞

# Django 3.0 #

*本次关于django 3.0 的教程全部是基于 Windows 10 和 Python 3.8 的基础上。*

## 建立虚拟环境 ##

在CMD（命令提示符）中输入以下命令建立一个名为django的虚拟环境。

mkvirtualenv django

建立虚拟环境成功之后，会自动进入虚拟环境。

## 安装Django 3.0 ##

直接安装django就会是最新的版本，这里我们需要的正是Django 3.0版本。

另外我们使用豆瓣源进行安装，以此来提高安装速度。

pip install django -i https://pypi.douban.com/simple/

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80Mjg1Njg3MQ_size_16_color_FFFFFF_t_70_pic_center]

## 创建项目 ##

继续在CMD中输入以下命令来建立一个名为`mysite`的项目。

# 想把项目建立在哪个文件夹中，进入文件夹 (可忽略)
    cd Desktop
    
    # 创建项目
    django-admin startproject mysite

接下来我们可以进入`mysite`文件夹中，来测试项目是否建立成功。

# 进入mysite文件夹
    cd mysite

查看`mysite`文件夹中有哪些文件。

dir

我们可以看到有一个`manage.py`文件，我们运行用以下这个命令运行这个文件即可。

# 默认端口是8000
    python manage.py runserver
    
    # 自定义端口
    python manage.py runserver 8080
    
    # 其他电脑也可以访问
    # 我们要把需要访问电脑得ip地址加入到mysite/settings.py中ALLOWED_HOSTS中
    python manage.py runserver 0.0.0.0:8000

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80Mjg1Njg3MQ_size_16_color_FFFFFF_t_70_pic_center 1]

如果看到以上界面之后，我们便可以在浏览器中访问http://127.0.0.1:8000/，如果访问成功，便代表项目建立成功。

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80Mjg1Njg3MQ_size_16_color_FFFFFF_t_70_pic_center 2]

## 创建投票应用 ##

继续在CMD中输入以下命令来建立一个名为`polls`的应用。

python manage.py startapp polls

## 在PyCharm中打开项目 ##

### 配置环境 ###

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80Mjg1Njg3MQ_size_16_color_FFFFFF_t_70_pic_center 3]

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

**polls/views.py**

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

**在polls 目录里新建一个 `urls.py` 文件**

**polls/urls.py**

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

**在 `mysite/urls.py` 文件的 `urlpatterns` 列表里插入一个 `include()`**

**mysite/urls.py**

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

*这样一个简单得视图便完成了。*

\*\*接下来我们可以在浏览器中访问。\*\*http://127.0.0.1:8000/polls/

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80Mjg1Njg3MQ_size_16_color_FFFFFF_t_70_pic_center 4]

### 数据库配置 ###

*这里我们使用得数据库是MySQL 5.7及以上版本，Python版本是3.8。*

首先我们需要安装一个用于连接Python和MySQL得工具包 `mysqlclient`

pip install mysqlclient

这样得安装方式是无法安装成功的。

#### mysqlclient 下载 ####

*mysqlclient的安装对于windows来说比较复杂。*

##### Windows： #####

在 https://www.lfd.uci.edu/~gohlke/pythonlibs/\#mysqlclient 中找到对应的版本，可以直接将包下载下来，再进行安装。  
[mysqlclient][]  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80Mjg1Njg3MQ_size_16_color_FFFFFF_t_70_pic_center 5]

#### mysqlclient 安装 ####

pip install mysqlclient-1.4.6-cp38-cp38-win32.whl

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80Mjg1Njg3MQ_size_16_color_FFFFFF_t_70_pic_center 6]

##### macOS #####

安装MySQL和mysqlclient

# 确保是Python3环境
    $ brew install mysql
    $ pip install mysqlclient

如果不想装MySQL，而是只要mysqlclient

$ brew install mysql-client
    $ echo 'export PATH="/usr/local/opt/mysql-client/bin:$PATH"' >> ~/.bash_profile
    $ export PATH="/usr/local/opt/mysql-client/bin:$PATH"
    $ pip install mysqlclient

##### Debian / Ubuntu: #####

$ sudo apt-get install python3-dev default-libmysqlclient-dev build-essential
    $ pip install mysqlclient

##### Red Hat / CentOS #####

% sudo yum install python3-devel mysql-devel
    $ pip install mysqlclient

#### 建立数据库 ####

在MySQL中建立名为在MySQL中`mysite`的数据库。

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80Mjg1Njg3MQ_size_16_color_FFFFFF_t_70_pic_center 7]

**mysite/settings.py**

DATABASES = { 
        'default': { 
            'ENGINE': 'django.db.backends.mysql',
            'NAME': 'mysite',
            'USER': 'root',
            'PORT': 3306,
            'PASSWORD': '123456',
            'HOST': '127.0.0.1'
        }
    }

到这里我们完成了数据库的配置。

接下来我们执行命令

python manage.py migrate

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80Mjg1Njg3MQ_size_16_color_FFFFFF_t_70_pic_center 8]

我们看到数据库中已经有了默认创建的表，代表数据库配置成功。

### 创建模型 ###

**polls/models.py**

import datetime
    
    from django.db import models
    
    
    # Create your models here.
    from django.utils import timezone
    
    
    class Question(models.Model):
        question_text = models.CharField(max_length=200)
        pub_date = models.DateTimeField('date published')
    
        def __str__(self):
            return self.question_text
    
        def was_published_recently(self):
            return self.pub_date >= timezone.now() - datetime.timedelta(days=1)
    
    
    class Choice(models.Model):
        question = models.ForeignKey(Question, on_delete=models.CASCADE)
        choice_text = models.CharField(max_length=200)
        votes = models.IntegerField(default=0)
    
        def __str__(self):
            return self.choice_text

### 激活模型 ###

**mysite/settings.py**

INSTALLED_APPS = [
        'django.contrib.admin',
        'django.contrib.auth',
        'django.contrib.contenttypes',
        'django.contrib.sessions',
        'django.contrib.messages',
        'django.contrib.staticfiles',
    
        # 激活模型
        'polls.apps.PollsConfig',
    ]

运行下面的命令

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 有一个自动执行数据库迁移并同步管理你的数据库结构的命令 - 这个命令是 [`migrate`][migrate]，我们马上就会接触它 - 但是首先，让我们看看迁移命令会执行哪些 SQL 语句。[`sqlmigrate`][sqlmigrate] 命令接收一个迁移的名称，然后返回对应的 SQL：

python manage.py sqlmigrate polls 0001

你将会看到类似下面这样的输出

BEGIN;
    --
    -- Create model Choice
    --
    CREATE TABLE "polls_choice" (
        "id" serial NOT NULL PRIMARY KEY,
        "choice_text" varchar(200) NOT NULL,
        "votes" integer NOT NULL
    );
    --
    -- Create model Question
    --
    CREATE TABLE "polls_question" (
        "id" serial NOT NULL PRIMARY KEY,
        "question_text" varchar(200) NOT NULL,
        "pub_date" timestamp with time zone NOT NULL
    );
    --
    -- Add field question to choice
    --
    ALTER TABLE "polls_choice" ADD COLUMN "question_id" integer NOT NULL;
    ALTER TABLE "polls_choice" ALTER COLUMN "question_id" DROP DEFAULT;
    CREATE INDEX "polls_choice_7aa0f6ee" ON "polls_choice" ("question_id");
    ALTER TABLE "polls_choice"
      ADD CONSTRAINT "polls_choice_question_id_246c99a640fbbd72_fk_polls_question_id"
        FOREIGN KEY ("question_id")
        REFERENCES "polls_question" ("id")
        DEFERRABLE INITIALLY DEFERRED;
    
    COMMIT;

我们再次运行以下命令，完成数据库迁移。

python manage.py migrate

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80Mjg1Njg3MQ_size_16_color_FFFFFF_t_70_pic_center 9]

当每次我们修改模型之后，我们需要重新生成迁移文件，然后将数据库迁移。

*  编辑 `models.py` 文件，改变模型。
 *  运行 [`python manage.py makemigrations`][python manage.py makemigrations] 为模型的改变生成迁移文件。
 *  运行 [`python manage.py migrate`][migrate] 来应用数据库迁移。

## Django 管理页面 ##

### 创建一个管理员账号 ###

python manage.py createsuperuser

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80Mjg1Njg3MQ_size_16_color_FFFFFF_t_70_pic_center 10]

### 登陆管理页面 ###

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80Mjg1Njg3MQ_size_16_color_FFFFFF_t_70_pic_center 11]

进入管理页面之后，用之前创建的admin账号进行登陆。

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80Mjg1Njg3MQ_size_16_color_FFFFFF_t_70_pic_center 12]

### 向管理页面中加入投票应用 ###

**polls/admin.py**

from django.contrib import admin
    from .models import Question
    from .models import Choice
    
    # Register your models here.
    
    
    admin.site.register(Question)
    admin.site.register(Choice)

我们在管理页面中可以看到投票应用已经成功添加了。

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80Mjg1Njg3MQ_size_16_color_FFFFFF_t_70_pic_center 13]

## 添加更多的视图 ##

在我们的投票应用中，我们需要下列几个视图：

*  问题索引页——展示最近的几个投票问题。
 *  问题详情页——展示某个投票的问题和不带结果的选项列表。
 *  问题结果页——展示某个投票的结果。
 *  投票处理器——用于响应用户为某个问题的特定选项投票的操作。

**polls/views.py**

添加更多的视图

from django.http import HttpResponse
    from django.shortcuts import render
    from django.shortcuts import get_object_or_404
    
    from polls.models import Question
    
    # Create your views here.
    
    
    def index(request):
        latest_question_list = Question.objects.order_by('-pub_date')[:5]
        context = { 'latest_question_list': latest_question_list}
        return render(request, 'polls/index.html', context)
    
    
    def detail(request, question_id):
        question = get_object_or_404(Question, pk=question_id)
        return render(request, 'polls/detail.html', { 'question': question})
    
    
    def results(request, question_id):
        response = "You're looking at the results of question %s."
        return HttpResponse(response % question_id)
    
    
    def vote(request, question_id):
        return HttpResponse("You're voting on question %s." % question_id)

**polls/urls.py**

将视图函数添加到polls/urls.py模块中

from django.urls import path
    
    from . import views
    
    # 为 URL 名称添加命名空间
    app_name = 'polls'
    
    urlpatterns = [
        # ex: /polls/
        path('', views.index, name='index'),
        # ex: /polls/5/
        path('<int:question_id>/', views.detail, name='detail'),
        # ex: /polls/5/results/
        path('<int:question_id>/results/', views.results, name='results'),
        # ex: /polls/5/vote/
        path('<int:question_id>/vote/', views.vote, name='vote'),
    ]

## 为 URL 名称添加命名空间 ##

教程项目只有一个应用，`polls` 。在一个真实的 Django 项目中，可能会有五个，十个，二十个，甚至更多应用。Django 如何分辨重名的 URL 呢？举个例子，`polls` 应用有 `detail` 视图，可能另一个博客应用也有同名的视图。Django 如何知道 `{% url %}` 标签到底对应哪一个应用的 URL 呢？

除了上面的在polls/urls.py模块中，为URL名称添加命名空间。我们也可以在mysite/urls.py模块中为URL名称添加命名空间。

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

## 模板 ##

在 `polls` 目录里创建一个 `templates` 目录。Django 将会在这个目录里查找模板文件。

**polls/templates/polls/index.html**

<!DOCTYPE html>
    <html lang="en">
    <head>
        <meta charset="UTF-8">
        <title>Title</title>
    </head>
    <body>
    {% if latest_question_list %}
        <ul>
        {% for question in latest_question_list %}
            <li><a href="{% url 'polls:detail' question.id %}">{
       { question.question_text }}</a></li>
        {% endfor %}
        </ul>
    {% else %}
        <p>No polls are available.</p>
    {% endif %}
    </body>
    </html>

**polls/templates/polls/detail.html**

<h1>{
       { question.question_text }}</h1>
    
    {% if error_message %}<p><strong>{
       { error_message }}</strong></p>{% endif %}
    
    <form action="{% url 'polls:vote' question.id %}" method="post">
    {% csrf_token %}
    {% for choice in question.choice_set.all %}
        <input type="radio" name="choice" id="choice{
       { forloop.counter }}" value="{
       { choice.id }}">
        <label for="choice{
       { forloop.counter }}">{
       { choice.choice_text }}</label><br>
    {% endfor %}
    <input type="submit" value="Vote">
    </form>

polls/templates/polls/detail.html\*\*

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80Mjg1Njg3MQ_size_16_color_FFFFFF_t_70_pic_center]: /images/20230528/b8cadcd49f9f4ce7b2bf4db95349fa95.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80Mjg1Njg3MQ_size_16_color_FFFFFF_t_70_pic_center 1]: /images/20230528/e7563c3080354951bc206960d30511ce.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80Mjg1Njg3MQ_size_16_color_FFFFFF_t_70_pic_center 2]: /images/20230528/c68442ca46214630ab371248e61b58c5.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80Mjg1Njg3MQ_size_16_color_FFFFFF_t_70_pic_center 3]: /images/20230528/8eaa8576167d4ea98c95728ffb3e39b6.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80Mjg1Njg3MQ_size_16_color_FFFFFF_t_70_pic_center 4]: /images/20230528/b9449c24d44c49c5aef053186e045ac8.png
[mysqlclient]: https://download.csdn.net/download/weixin_42856871/12151430
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80Mjg1Njg3MQ_size_16_color_FFFFFF_t_70_pic_center 5]: /images/20230528/db199fa307c74c35bb6ed29b0cd67ff4.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80Mjg1Njg3MQ_size_16_color_FFFFFF_t_70_pic_center 6]: /images/20230528/cc903c6225de4163bbc3af841f3df1d4.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80Mjg1Njg3MQ_size_16_color_FFFFFF_t_70_pic_center 7]: /images/20230528/fc15e36b886643fbaeffb6c369515145.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80Mjg1Njg3MQ_size_16_color_FFFFFF_t_70_pic_center 8]: /images/20230528/c7e9d1592f854b529959a51645facf6b.png
[migrate]: https://docs.djangoproject.com/zh-hans/3.0/ref/django-admin/#django-admin-migrate
[sqlmigrate]: https://docs.djangoproject.com/zh-hans/3.0/ref/django-admin/#django-admin-sqlmigrate
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80Mjg1Njg3MQ_size_16_color_FFFFFF_t_70_pic_center 9]: /images/20230528/49bd651149cd42d5945ff982123843a9.png
[python manage.py makemigrations]: https://docs.djangoproject.com/zh-hans/3.0/ref/django-admin/#django-admin-makemigrations
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80Mjg1Njg3MQ_size_16_color_FFFFFF_t_70_pic_center 10]: /images/20230528/99b0535dbe684570aa6dfc135337e986.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80Mjg1Njg3MQ_size_16_color_FFFFFF_t_70_pic_center 11]: /images/20230528/8f6b07469dc94425811a2910ca6ac712.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80Mjg1Njg3MQ_size_16_color_FFFFFF_t_70_pic_center 12]: /images/20230528/f875cece7ba24482b16e294a497887ea.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80Mjg1Njg3MQ_size_16_color_FFFFFF_t_70_pic_center 13]: /images/20230528/8fdcbd929a6e4a589f6d9b0f80874880.png