第一个Django应用程序
一、查看Django是否安装
如果Django已经安装,可以看到安装的版本号,如果没有安装则会看到“No module named django”的错误。
MacBook-Pro:~ h$ python3 -m django --version 1.11.11
二、创建一个项目
从命令行创建Django项目
django-admin startproject mysite
会在当前目录下生成一个mysite目录。
注意:给项目命名的时候,项目名称不能和Pychon或Django的内部组件名称同名。尤其,应该避免使用类似test(与Django自身冲突)或者django(与Python内建的包冲突)这个的名称。
startproject生成以下文件
MacBook-Pro:PycharmProjects h$ tree mysite mysite ├── manage.py └── mysite ├── __init__.py ├── settings.py ├── urls.py └── wsgi.py 1 directory, 5 files
文件含义:
- 外层的mysite/根目录仅仅是项目的一个容器。这个名字与Django无关,可以将其命名为任何内容(只要不和Django内置名称冲突)。
- manage.py:一个命令行工具,可以是你用多钟方式对Django项目进行交互。可以在django-admin和manage.py中读到关于manage.py的所有细节。
- 内层的mysite/目录是你的项目的真正的Python包。它是你导入任何东西时将需要使用的Python包的名字(例如:mysite.urls)。
- mysite/__init__.py:一个空简介,它告诉Python这个目录应该被看作一个Python包。
- mysite/settings.py:该Django项目的设置/配置。Django settings将告诉你这些设置如何工作。
- mysite/url.py:此Django项目的URL声明:Django驱动的网址的“目录”。
- mysite/wsgi.py:用于你的项目的与WSGI兼容的Web服务器入口。
启动服务
切换到mysite目录内,执行以下命令:
python3 manage.py runserver
命令输出为以下内容:
Performing system checks... System check identified no issues (0 silenced). You have 13 unapplied migration(s). Your project may not work properly until you apply the migrations for app(s): admin, auth, contenttypes, sessions. Run 'python manage.py migrate' to apply them. June 12, 2018 - 13:04:52 Django version 1.11.11, using settings 'mysite2.settings' Starting development server at http://127.0.0.1:8000/ Quit the server with CONTROL-C.
注意:暂时忽略有关未应用数据库迁移的告警;我们很快就处理数据库。
你已经开始使用Django开服务器,这是一个纯粹用Python编写的轻量级Web服务器。在Django中包含了这个功能,所以您可以快速开发,而无需处理配置生产服务器(如Apache),
直到你准备上线。
注意:此服务器仅供开发时使用。
现在服务器正在运行,请使用浏览器访问http://127.0.0.1:8000/,你将看懂一个”Welcom to Django”的页面。如下图所示:
更改默认端口
默认情况下,runserver命令在内部IP的8000端口启动开发服务器。
如果需要改变服务器的端口,把要使用的端口作为一个命令行参数传递给它,示例:在端口8080上启动服务器:
python3 manage.py runserver 8080
如果需要改变服务器的IP地址,把IP地址和端口号防盗一起,例如:要监听服务器上所有IP地址:
python3 manage.py runserver 0:8000
0时0.0.0.0的快捷方式。
runserver自动重载
开发服务器会根据需要自动重新载入Python代码。不必为了使更改的代码生效而重启服务器,然而,一些行为:比如添加文件,不会出发服务器的重启,所以在这种情况下需要手动重启服务器。
创建一个应用程序
一个项目已经建立起来了。在编写每个Django应用都是遵循特定约定且包含一个Python包。Django自带一个工具,它可以自动生成应用的基本目录结构。
应用与项目的区别
项目与应用之间有什么不同?应用是一个Web应用程序,它完成具体的事项--比如一个博客系统、一个存储公共档案的数据库或者一个简单的投票应用。一个项目是特定网站的配置和应用程序的集合。一个项目可以包含多个应用。一个应用可以运用到多个项目中去。
要创建您的应用程序,请确保您位于相同的目录中manage.py、并输入以下命令:
python3 manage.py startapp polls
这将创建一个目录polls,其目录结构如下:
polls/ ├── __init__.py ├── admin.py ├── apps.py ├── migrations │ └── __init__.py ├── models.py ├── tests.py └── views.py 1 directory, 7 files
polls应用将基于这个目录结构。
我们来写第一个视图,打开文件pools/views.py,并在其中写入以下代码:
from django.http import HttpResponse def index(request): return HttpResponse("Hello,world.You're at the polls index.")
要调用视图,我们需要将其映射到URL,因此需要一个url的配置文件。要在polls目录中创建url配置文件,创建一个名为urls.py。现在app(pools)目录下结构如下所示:
polls/ ├── __init__.py ├── admin.py ├── apps.py ├── migrations │ └── __init__.py ├── models.py ├── tests.py ├── urls.py └── views.py 1 directory, 8 files
在polls/urls.py文件中写入以下代码:
from django.conf.urls import url from . import views urlpatterns = [ url(r'^$',views.index,name='index'), ]
下一步是将根url.py指向polls.url模块,在mysite/urls.py中,添加对django.conf.url.include的导入,并在urlpatterns列表中插入一个include(),结果如下:
from django.conf.urls import url,include from django.contrib import admin urlpatterns = [ url(r'pools/',include('polls.urls')), url(r'^admin/', admin.site.urls), ]
include()方法允许引用其它URLconfs。注意:include()函数的正则表达式不具有$(字符串结束的匹配字符),而是使用尾部斜线进行表示。每当Django遇到include()时,它会排除
与此相同的任何部分,并将剩余的字符串发送到随附的URLconf进行进一步处理。
当你项目中包含其它URL模式时,应始终使用include()。admin.site.urls是唯一的例外。
何时使用include()
运行以下命令启动服务:
python3 manage.py runserver
在浏览器中访问http://127.0.0.1:8000/polls/
url()函数传递四个参数
两个必须的参数:正则表达式regex和视图view,两个可选项:kwargs和name。
url()argument:regex
正则表达式,它是用于匹配字符串中的模式的语法,或者在这种情况下是url模式。Django从第一个正则表达式开始,并将其放在列表中,将请求的URL与每个正则表达式进行比较,直到找到匹配的一个。 请注意,这些正则表达式不搜索GET和POST参数或域名。例如,在https://www.example.com/myapp/的请求中,URLconf将查找myapp/。在https://www.example.com/myapp/?page=3的请求中,URLconf同样查找myapp/。
url()argument:view
当Django发现正则表达式匹配时,Django将调用指定的视图函数,使用HttpRequest对象作为第一个参数,并将正则表达式中的任何“捕获”值作为其它参数。如果正则表达式使用简单的捕获,则值作为位置参数传递;如果它使用命名捕获,则值作为关键字参数传递。
url()argument:kwargs
任意关键字参数可以在字典汇总传递到目标视图
url()argument:name
命名你的URL可让你从Django其它地方明确地应用它,特别是在模版中。