Django基础实例教程(1)

前提：已安装Django
查看Django版本：命令行输入以查看Django版本

python -m django --version

注：Django4.2支持python3.8以后的版本

1. 创建项目

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

django-admin startproject mysite

mysite:新建的项目名称，可自定义
这行代码会在目录下创建mysite目录
注：避免使用Python和Django的内部保留字来命名项目
下图是新建项目后自动生成的文件

mysite/
    manage.py
    mysite/
        __init__.py
        settings.py
        urls.py
        asgi.py
        wsgi.py

mysite/:项目容器，无任何影响，可重命名
manage.py:管理django项目的命令行工具
	https://docs.djangoproject.com/zh-hans/4.2/ref/django-admin/
	
里面一层的 mysite/：纯python包，名称就是你引用它内部任何东西时用到的python包名

mysite/__init__.py：空文件，告诉python这个目录应当被认作一个python包
mysite/settings.py：Django项目的配置文件
mysite/urls.py：Django 项目的 URL 声明，就像你网站的“目录”。
mysite/asgi.py：作为你的项目的运行在 ASGI 兼容的 Web 服务器上的入口。
mysite/wsgi.py：作为你的项目的运行在 WSGI 兼容的Web服务器上的入口。

2.运行服务

在manage.py那一层目录，执行下列命令行

python manage.py runserver

访问给的网址

更换服务器监听的IP或端口：

python manage.py runserver 0.0.0.0:8000

网站能够访问说明成功运行，项目已经配置好。

3. 创建应用

项目已经配置好，下一步是创建应用。

项目和应用的区别： 项目则是一个网站使用的配置和应用的集合。项目可以包含很多个应用。应用可以被很多个项目使用

1.在 manage.py 所在的目录下，然后运行命令来创建一个应用：

python manage.py startapp polls

polls:应用名称

2.编写视图：打开 polls/views.py,输入下列代码

from django.http import HttpResponse


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

这是最简单的视图，如果想要看见效果，需要设置url。打开polls/urls.py 中，输入如下代码：
（目录下没有文件需要手动创建）

from django.urls import path

from . import views

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

下一步：在 mysite/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/polls/，你应该能够看见 “Hello, world. You’re at the polls index.” ，这是你在 index 视图中定义的。

上图中的函数 path() 具有四个参数，两个必须参数：route 和 view，两个可选参数：kwargs 和 name。

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 模式。

原网址：https://docs.djangoproject.com/zh-hans/4.2/intro/tutorial01/