编写第一个Django应用|编写第一个Django应用 (一)
本文是Django系列文章,请到无聊才读书的博客了解更多详细信息。在本教程中,我们将引导您完成基本民意调查应用程序的创建。
编写第一个Django应用,第1部分
它由两部分组成:
- 一个允许人们查看民意测验并对其进行投票的公共站点。
- 一个允许您添加,更改和删除民意调查的管理站点。
$ python -m django --version
如果安装了Django,则应该看到安装的版本。如果不是,您将得到一个错误消息,提示“没有名为django的模块”。
本教程是为Django 2.2编写的,它支持Python 3.5及更高版本。如果Django版本不匹配,则可以使用此页面右下角的版本切换器来参考您的Django版本的教程,或将Django更新为最新版本。如果您使用的是Python的旧版本,请检查我可以在Django中使用哪个Python版本?找到兼容版本的Django。
请参阅如何安装Django,以获取有关如何删除Django的较早版本并安装较新版本的建议。
在哪里获得帮助:创建项目? 如果这是您第一次使用Django,则必须进行一些初始设置。即,您将需要自动生成一些代码来建立Django 项目 -Django实例的一组设置,包括数据库配置,特定于Django的选项和特定于应用程序的设置。
如果您在阅读本教程时遇到麻烦,请向django用户发布消息,或在irc.freenode.net上通过#django来与其他可能会提供帮助的Django用户聊天。
从命令行
cd
进入要存储代码的目录,然后运行以下命令:$ django-admin startproject mysite
这将
mysite
在当前目录中创建一个目录。如果它不起作用,请参阅运行django-admin时遇到的问题。注意
您需要避免使用内置的Python或Django组件来命名项目。特别是,这意味着您应该避免使用类似django
(与Django本身冲突)或test
(与内置Python包冲突)之类的名称。
该代码应该放在哪里?将代码放在文档根目录之外的某个目录中,例如
如果您的背景是纯朴的旧PHP(不使用现代框架),则可能习惯于将代码放在Web服务器的文档根目录下(例如/var/www
)。使用Django,您无需这么做。将任何这些Python代码放在??Web服务器的文档根目录中不是一个好主意,因为这冒着人们可能能够通过Web查看您的代码的风险。这对安全性不利。
/home/mycode
。让我们看看
startproject
创建了什么:mysite/
manage.py
mysite/
__init__.py
settings.py
urls.py
wsgi.py
这些文件是:
- 外部
mysite/
根目录只是您的项目的容器。它的名称与Django无关;您可以将其重命名为任何喜欢的名称。 -
manage.py
:一个命令行实用程序,可让您以各种方式与该Django项目进行交互。您可以manage.py
在django-admin和manage.py中阅读有关的所有详细信息 。 - 内部
mysite/
目录是项目的实际Python包。它的名称是Python包名称,您需要使用它来导入其中的任何内容(例如mysite.urls
)。 -
mysite/__init__.py
:一个空文件,告诉Python该目录应视为Python软件包。如果您是Python初学者,请在Python官方文档中阅读有关包的更多信息。 -
mysite/settings.py
:此Django项目的设置/配置。 Django设置将告诉您所有设置的工作方式。 -
mysite/urls.py
:此Django项目的URL声明;Django支持的网站的“目录”。您可以在URL调度程序中阅读有关URL的更多信息。 -
mysite/wsgi.py
:兼容WSGI的Web服务器为您的项目提供服务的入口点。有关更多详细信息,请参见如何使用WSGI进行部署。
mysite
如果尚未进入外部目录,请运行以下命令:$ python manage.py runserver
您将在命令行上看到以下输出:
Performing system checks...System check identified no issues (0 silenced).You have unapplied migrations;
your app may not work properly until they are applied.
Run 'python manage.py migrate' to apply them.October 16, 2019 - 15:50:53
Django version 2.2, using settings 'mysite.settings'
Starting development server at [http://127.0.0.1:8000/](http://127.0.0.1:8000/)
Quit the server with CONTROL-C.
注意您已经启动了Django开发服务器,这是一个纯Python编写的轻量级Web服务器。我们已经将它包含在Django中,因此您可以快速进行开发,而无需准备配置生产服务器(例如Apache),直到准备好进行生产为止。
暂时忽略有关未应用数据库迁移的警告;我们将尽快处理数据库。
现在是要注意的好时机:请勿在类似于生产环境的任何环境中使用此服务器。仅在开发时使用。(我们的业务是制作Web框架,而不是Web服务器。)
现在服务器已在运行,请使用Web浏览器访问http://127.0.0.1:8000/。您会看到“恭喜!”页面,其中一枚火箭正在起飞。有效!
更改端口
默认情况下,该runserver
命令在内部IP的端口8000上启动开发服务器。
如果要更改服务器的端口,请将其作为命令行参数传递。例如,此命令在端口8080上启动服务器:
$ python manage.py runserver 8080
如果要更改服务器的IP,请将其与端口一起传递。例如,要侦听所有可用的公共IP(如果您正在运行Vagrant或想在网络上的其他计算机上炫耀您的工作,这很有用),请使用:
$ python manage.py runserver 0:8000
0是0.0.0.0的快捷方式。有关开发服务器的完整文档,请参见runserver
参考资料。
自动重新加载开发服务器会根据需要自动为每个请求重新加载Python代码。您无需重新启动服务器即可使代码更改生效。但是,某些操作(例如添加文件)不会触发重新启动,因此在这种情况下,您必须重新启动服务器。runserver
创建民意调查应用程序 现在,您的环境(一个“项目”)已设置好,您就可以开始工作了。
您在Django中编写的每个应用程序都包含一个遵循特定约定的Python包。Django附带了一个实用程序,该实用程序会自动生成应用程序的基本目录结构,因此您可以专注于编写代码,而不是创建目录。
项目与应用您的应用程序可以放在Python路径上的任何位置。在本教程中,我们将在
项目和应用之间有什么区别?应用程序是执行某项操作的Web应用程序,例如Weblog系统,公共记录数据库或简单的民意调查应用程序。项目是特定网站的配置和应用程序的集合。一个项目可以包含多个应用程序。一个应用程序可以在多个项目中。
manage.py
文件旁边创建轮询应用程序,以便可以将其作为自己的顶级模块(而不是的子模块)导入mysite
。要创建您的应用,请确保与您位于同一目录,
manage.py
然后键入以下命令:$ python manage.py startapp polls
这将创建一个目录
polls
,其布局如下所示:polls/
__init__.py
admin.py
apps.py
migrations/
__init__.py
models.py
tests.py
views.py
此目录结构将容纳轮询应用程序。
写下您的第一个视图 让我们来写第一个视图。打开文件
polls/views.py
,并将以下Python代码放入其中:polls/views.py
from django.http import HttpResponsedef index(request):
return HttpResponse("Hello, world. You're at the polls index.")
这是Django中最简单的视图。要调用该视图,我们需要将其映射到URL-为此,我们需要一个URLconf。
要在民意调查目录中创建URLconf,请创建一个名为
urls.py
的文件。您的应用目录现在应如下所示:polls/
__init__.py
admin.py
apps.py
migrations/
__init__.py
models.py
tests.py
urls.py
views.py
在
polls/urls.py
文件中包含以下代码:polls/urls.py
from django.urls import pathfrom . import viewsurlpatterns = [
path('', views.index, name='index'),
]
下一步是将根URLconf指向该
polls.urls
模块。在中 mysite/urls.py
,添加的导入django.urls.include
并将插入 include()
到urlpatterns
列表中,因此您具有:mysite/urls.py
from django.contrib import admin
from django.urls import include, pathurlpatterns = [
path('polls/', include('polls.urls')),
path('admin/', admin.site.urls),
]
该
include()
功能允许引用其他URLconf。每当Django遇到时include()
,它都会截断直到该时间点匹配的URL的任何部分,并将剩余的字符串发送到包含的URLconf中以进行进一步处理。背后的想法
include()
是简化URL的即插即用。由于民意调查位于其自己的URLconf(polls/urls.py
)中,因此可以将其放在“ / polls /”下,或者“ / fun_polls /”下,或者“ / content / polls /”下或任何其他路径根下,并且该应用仍会工作。何时使用现在,您已将include()
include()
包括其他URL模式时,应始终使用。admin.site.urls
是唯一的例外。
index
视图连接到URLconf。验证它是否与以下命令一起使用:$ python manage.py runserver
在浏览器中转到http:// localhost:8000 / polls /,您应该看到文本“ Hello,world。您正在民意调查索引中。”(您在
index
视图中定义的) 。网页未找到?该
如果您在这里看到错误页面,请检查您是否要访问 http:// localhost:8000 / polls /而不是http:// localhost:8000 /。
path()
函数传递了四个参数,两个是必需的 route
和view
,以及两个可选的kwargs
和name
。在这一点上,有必要回顾一下这些论点的含义。path()
参数:route
? route
是包含URL模式的字符串。在处理请求时,Django从第一个模式开始,urlpatterns
然后沿列表向下移动,将请求的URL与每个模式进行比较,直到找到匹配的URL。模式不搜索GET和POST参数或域名。例如,在对的请求中
https://www.example.com/myapp/
,URLconf将寻找 myapp/
。在请求中https://www.example.com/myapp/?page=3
,URLconf也将寻找myapp/
。path()
参数:view
? 当Django找到匹配的模式时,它将使用
HttpRequest
对象作为第一个参数,并将路线中所有“捕获的”值作为关键字参数,调用指定的view函数。我们将举一个例子。path()
参数:kwargs
? 可以在字典中将任意关键字参数传递给目标视图。在本教程中,我们将不使用Django的此功能。
path()
参数:name
? 命名URL可以使您在Django中的其他地方(尤其是在模板内部)明确地引用它。这项强大的功能可让您仅触摸单个文件即可对项目的URL模式进行全局更改。
【编写第一个Django应用|编写第一个Django应用 (一)】如果您对基本的请求和响应流程感到满意,请阅读 本教程的第2部分,开始使用数据库。
推荐阅读
- 标签、语法规范、内联框架、超链接、CSS的编写位置、CSS语法、开发工具、块和内联、常用选择器、后代元素选择器、伪类、伪元素。
- django-前后端交互
- 编写字典程序
- 用npm发布一个包的教程并编写一个vue的插件发布
- django2.2|django2.2 一般项目步骤(初步)
- 历史上的今天|【历史上的今天】2 月 16 日(世界上第一个 BBS 诞生;中国计算机教育开端;IBM 机器人赢得智能竞赛)
- 非暴力沟通05
- 第一个回合(??红龙,白风,蓝夜,黄种子)
- 依赖注入模块
- 开始你的第一个Echarts图表(分享自知乎网)