本篇不能算是一个原创的文档,只能说是在学习Django官网文档过程中的笔记,留作以后参考使用。勿喷!
前言
关于如何安装Django这里就不多叙述了,安装过程比较简单,这里主要说一下安装好Django之后写的第一个应用。这里使用的python是Python3.7(64Bit)的,django版本是2.0.7版本的。PC:win7 64bit
第一部分
1. 创建项目
在放置你代码的目录下,使用命令行运行如下命令:
django-admin.py startproject mysite
mysite: 是项目的名字,你可以取任意你喜欢的名字(合法就行)
执行完后会在当前目录下看到如下几个文件被创建了:
这些目录和文件的用处是:
最外层的:file: mysite/ 根目录只是你项目的容器。
manage.py: 一个让你用各种方式管理 Django 项目的命令行工具。
里面一层的 mysite/ 目录包含你的项目,它是一个纯 Python 包。它的名字就是当你引用它内部任何东西时需要用到的 Python 包名。 (比如 mysite.urls).
mysite/init.py:一个空文件,告诉 Python 这个目录应该被认为是一个 Python 包。
mysite/settings.py:Django 项目的配置文件。
mysite/urls.py:Django 项目的 URL 声明,就像你网站的“目录”。
mysite/wsgi.py:作为你的项目的运行在 WSGI 兼容的Web服务器上的入口。
2. 用于开发的简易服务器
进入到第一层mysite目录下执行:
python manage.py runserver
会看到如下:
注意:
默认情况下,runserver 命令会将服务器设置为监听本机内部 IP 的 8000 端口。
如果你想更换服务器的监听端口,请使用命令行参数。举个例子,下面的命令会使服务器监听 8080 端口:
python manage.py runserver 8080
如果你想要修改服务器监听的IP,在端口之前输入新的。比如,为了监听所有服务器的公开IP(这你运行 Vagrant 或想要向网络上的其它电脑展示你的成果时很有用),使用:
python manage.py runserver 0.0.0.0:8000
3 . 创建应用
现在你的开发环境——这个“项目” ——已经配置好了,你可以开始干活了。
在 Django 中,每一个应用都是一个 Python 包,并且遵循着相同的约定。Django 自带一个工具,可以帮你生成应用的基础目录结构,这样你就能专心写代码,而不是创建目录了。
项目和应用有啥区别?应用是一个专门做某件事的网络应用程序——比如博客系统,或者公共记录的数据库,或者简单的投票程序。项目则是一个网站使用的配置和应用的集合。项目可以包含很多个应用。应用可以被很多个项目使用。
创建一个应用,应用名为polls:
python manage.py startapp polls
这将会创建一个polls目录,目录结构大致如下:
4 . 编写第一个视图
打开 polls/views.py,把下面这些 Python 代码输入进去:
from django.http import HttpResponse
def index(request):
return HttpResponse("Hello, world. You're at the polls index.")
这是 Django 中最简单的视图。如果想看见效果,我们需要将一个 URL 映射到它——这就是我们需要 URLconf 的原因了。
为了创建 URLconf,请在 polls 目录里新建一个 urls.py 文件。当然也可以在顶层目录中的urls.py中写,但是为什么还要在应用目录下建一个新的urls.py的文件呢?这是为了应用更好的分离,继续往下你就明白了。
在 polls/urls.py 中,输入如下代码:
from django.urls import path
from . import views
urlpatterns = [
path('', views.index, name='index'),
]
下一步是要在根 URLconf 文件中指定我们创建的 polls.urls 模块。在 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),
]
函数 include() 允许引用其它 URLconfs。每当 Django 遇到 :func:~django.urls.include 时,它会截断与此项匹配的 URL 的部分,并将剩余的字符串发送到 URLconf 以供进一步处理。在2.0之前的版本是没有include()函数的。
设计 include() 的理念是使其可以即插即用。因为投票应用有它自己的 URLconf( polls/urls.py ),他们能够被放在 “/polls/” , “/fun_polls/” ,”/content/polls/”,或者其他任何路径下,这个应用都能够正常工作。当包括其它 URL 模式时你应该总是使用 include() , 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。
1. route 是一个匹配 URL 的准则(类似正则表达式)。当 Django 响应一个请求时,它会从 urlpatterns 的第一项开始,按顺序依次匹配列表中的项,直到找到匹配的项。
这些准则不会匹配 GET 和 POST 参数或域名。例如,URLconf 在处理请求 https://www.example.com/myapp/ 时,它会尝试匹配 myapp/ 。处理请求 https://www.example.com/myapp/?page=3 时,也只会尝试匹配 myapp/。
2.view当 Django 找到了一个匹配的准则,就会调用这个特定的视图函数,并传入一个 HttpRequest 对象作为第一个参数,被“捕获”的参数以关键字参数的形式传入。
3.kwargs任意个关键字参数可以作为一个字典传递给目标视图函数。
4.name为你的 URL 取名能使你在 Django 的任意地方唯一地引用它,尤其是在模板中。这个有用的特性允许你只改一个文件就能全局地修改某个 URL 模式。
好了本篇就到此,基本了解请求和响应流程,后面会有第二部分开始使用数据库。谢谢