- 安装Django:首先,确保已经安装了 Python,并使用 pip(Python 包管理器)安装
Django。你可以在命令行中运行以下命令进行安装:
pip install Django
- 创建 Django 项目:使用 Django 的命令行工具创建一个新的 Django 项目。在命令行中,导航到你想要创建项目的目录,并运行以下命令:
django-admin startproject projectname
这将创建一个名为 “projectname” 的新项目目录。
- 创建 Django 应用:在 Django 中,一个项目可以由多个应用组成。每个应用负责处理特定的功能模块。在项目目录中,运行以下命令创建一个新的 Django 应用:
python manage.py startapp appname
这将在项目目录中创建一个名为 “appname” 的新应用目录。
- 编写视图,打开 appname/views.py
from django.http import HttpResponse
def index(request):
return HttpResponse("Hello, world. You're at the appname index.")
将一个 URL 映射到它,appname/urls.py 中,输入如下代码:
from django.urls import path
from . import views
urlpatterns = [
path("", views.index, name="index"),
]
下一步是要在根 URLconf 文件中指定我们创建的 polls.urls 模块。在 projectname/urls.py 文件的 urlpatterns 列表里插入一个 include(), 如下:
from django.contrib import admin
from django.urls import include, path
urlpatterns = [
path("polls/", include("polls.urls")),
path("admin/", admin.site.urls),
]
通过以下命令验证是否正常工作:
python manage.py runserver
使用电脑打开http://localhost:8000/appname/应该能够看见 “Hello, world. You’re at the appname index.” ,这是在 index 视图中定义的。
函数 path() 具有四个参数,两个必须参数:route 和 view,两个可选参数:kwargs 和 name。现在,是时候来研究这些参数的含义了。
path() 参数: route
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 模式。
- 配置数据库:编辑项目目录中的 settings.py 文件,配置数据库连接。你可以选择使用内置的 SQLite
数据库或其他常用数据库,如 MySQL 或 PostgreSQL。我使用的是MySQL。
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.mysql',
'NAME': 'first',
'USER': 'root',
'PASSWORD': '123456',
'HOST': 'localhost',
'PORT': '3306',
'OPTIONS': {
'init_command': "SET sql_mode='STRICT_TRANS_TABLES'; SET time_zone='Asia/Shanghai'",
},
}
}
TIME_ZONE = 'Asia/Shanghai'
USE_TZ = True
编辑 mysite/settings.py 文件前,先设置 TIME_ZONE 为你自己时区。
此外,关注一下文件头部的 INSTALLED_APPS 设置项。这里包括了会在你项目中启用的所有 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 文件中的数据库配置和随应用提供的数据库迁移文件
- 定义模型:在应用目录中的 models.py 文件中定义数据模型。使用 Django 的模型类和字段来描述数据结构。
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)
- 激活模型
INSTALLED_APPS = [
"appname.apps.AppnameConfig",
"django.contrib.admin",
"django.contrib.auth",
"django.contrib.contenttypes",
"django.contrib.sessions",
"django.contrib.messages",
"django.contrib.staticfiles",
]
现在 Django 项目会包含 polls 应用。接着运行下面的命令:
python manage.py makemigrations appname
将会看到类似于下面这样的输出:
Migrations for 'appname':
appname/migrations/0001_initial.py
- Create model Question
- Create model Choice
运行 migrate 命令,在数据库里创建新定义的模型的数据表:
python manage.py migrate