进入你指定的项目保存目录,然后运行下面的命令:
$ django-admin startproject mysite
这将在目录下生成一个mysite目录,也就是你的这个Django项目的根目录。它包含了一系列自动生成的目录和文件,具备各自专有的用途。
注意:在给项目命名的时候必须避开Django和Python的保留关键字,比如“django”,“test”等,否则会引起冲突和莫名的错误。对于mysite的放置位置,不建议放在传统的/var/www目录下,它会具有一定的数据暴露危险,因此Django建议你将项目文件放在例如/home/mycode类似的位置。
一个新建立的项目结构大概如下:
mysite/ manage.py mysite/ __init__.py settings.py urls.py wsgi.py
各文件和目录解释:
外层的mysite/
目录与Django无关,只是你项目的容器,可以任意命名。
manage.py
:一个命令行工具,用于与Django进行不同方式的交互脚本,非常重要!
内层的mysite/
目录是真正的项目文件包裹目录,它的名字是你引用内部文件的包名,例如:mysite.urls
。
mysite/__init__.py
:一个定义包的空文件。
mysite/settings.py
:项目的主配置文件,非常重要!
mysite/urls.py
:路由文件,所有的任务都是从这里开始分配,相当于Django驱动站点的内容表格,非常重要!
mysite/wsgi.py
:一个基于WSGI的web服务器进入点,提供底层的网络通信功能,通常不用关心。
进入mystie项目的根目录,输入下面的命令:
$ python manage.py runserver
你会看到下面的提示,这表明Django的开发服务器已经启动,开始提供Web服务了:
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. September 10, 2017 - 15:50:53 Django version 1.10, using settings `mysite.settings' Starting development server at http://127.0.0.1:8000/ Quit the server with CONTROL-C.
Django提供了一个用于开发的web服务器,使你无需配置一个类似Ngnix的线上服务器,就能让站点运行起来。这是一个由Python编写的轻量级服务器,简易并且不安全,因此不要将它用于生产环境。
修改配置文件,图如下:
打开浏览器,访问http://127.0.0.1:8000/,你将看到Django的欢迎界面,一切OK!
Django的开发服务器(以后简称服务器)默认运行在内部的8000端口,如果你想指定端口,请在命令中显示给出:
$ python manage.py runserver 8080
如果想修改服务器的ip地址,请按下面的方式运行命令:
$ python manage.py runserver 0.0.0.0:8000
这时,Django将运行在8000端口,整个局域网内都将可以访问站点,而不只是是本机。
注意: Django的开发服务器具有自动重载功能,当你的代码有修改,每隔一段时间服务器将自动更新。但是,有一些例如增加文件的动作,不会触发服务器重载,这时就需要你自己手动重启。
app应用与project项目的区别:
一个app实现某个功能,比如博客、公共档案数据库或者简单的投票系统;
一个project是配置文件和多个app的集合,这些app组合成整个站点;
一个project可以包含多个app;
一个app可以属于多个project!
app的存放位置可以是任何地点,但是通常都将它们放在与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
在Pycharm中,没有可以创建app的图形化按钮,需要在下方的terminal
终端中输入命令:
python manage.py startapp polls
在polls/views.py
文件中,编写代码:
from django.http import HttpResponse from django.conf.urls import include def index(request): return HttpResponse("Hello, world. You're at the polls index.")
为了调用该视图,我们还需要编写urlconf,也就是路由路径。现在,在polls目录中新建一个文件,名字为urls.py
,在其中输入代码如下:
from django.conf.urls import url from . import views urlpatterns = [ url(r'^$', views.index, name='index'), ]
此时,目录的文件结构是这样的:
polls/ __init__.py admin.py apps.py migrations/ __init__.py models.py tests.py urls.py views.py
接下来,在项目的主urls文件中添加urlpattern
条目,指向我们刚才建立的polls这个app独有的urls文件,这里需要导入include模块。打开mysite/urls.py
文件,代码如下:
from django.conf.urls import include, url from django.contrib import admin from django.conf.urls import include urlpatterns = [ url(r'^polls/', include('polls.urls')), url(r'^admin/', admin.site.urls), ]
include语法相当于多级路由,它把接收到的url地址去除前面的正则表达式,将剩下的字符串传递给下一级路由进行判断。在路由的章节,有更加详细的用法指导。
include的背后是一种即插即用的思想。项目根路由不关心具体app的路由策略,只管往指定的二级路由转发,实现了应用解耦。app所属的二级路由可以根据自己的需要随意编写,不会和其它的app路由发生冲突。app目录可以放置在任何位置,而不用修改路由。这是软件设计里很常见的一种模式。
建议:除了admin路由外,尽量给每个app设计自己独立的二级路由。
好了,路由设置成功后,启动服务器,然后在浏览器中访问地址http://localhost:8000/polls/
。一切正常的话,你将看到“Hello, world. You’re at the polls index.”
打开浏览器出现:
免责声明:本站发布的内容(图片、视频和文字)以原创、转载和分享为主,文章观点不代表本网站立场,如果涉及侵权请联系站长邮箱:is@yisu.com进行举报,并提供相关证据,一经查实,将立刻删除涉嫌侵权内容。