Python开发入门与实战2-第一个Django项目

时间:2022-03-24 22:20:31

2.第一个Django项目

上一章节我们完成了python,django和数据库等运行环境的安装,现在我们来创建第一个django project吧,迈出使用django开发应用的第一步。

2.1.创建第一个Django项目

我们创建一个我们存放Django的工作目录,示例:C:\My Files\Python Projects 在命令提示符窗口进入到刚才创建的目录,运行运行命令:

django-admin.py startproject mysite

这样会在你的当前目录下创建一个目录mysite。

注意:确保在Windows PATH 环境变量中增加了django-admin.py文件路径:C:\Python27\Scripts,如没有增加路径可以通过运行如下命令:

path %path%; C:\Python27\Scripts

startproject 命令创建一个目录,包含内容如下:

Python开发入门与实战2-第一个Django项目

mysite/

manage.py   

mysite/

      __init__.py

      wsgi.py

      settings.py

      urls.py

目录及文件说明如下:

  • manage.py      :一种命令行工具,允许你以多种方式与该 Django 项目进行交互。 键入python manage.py      help,查看帮助。

mysite/ 下文件:

  • __init__.py :让 Python 把该目录当成一个开发包 (即一组模块)所需的文件。 这是一个空文件,一般不需要修改它。
  • settings.py :该文件是 Django 项目的设置或配置文件。
  • urls.py:Django项目的URL配置文件,其为你的django网站的目录。
  • wsgi.py:Django项目的wsgi配置,Web服务器网关接口文件(Python Web Server Gateway Interface,缩写为WSGI)。

2.2.运行开发服务器

django开发服务是可用在开发期间的,一个内建的,轻量的web服务。在准备发布产品之前,无需进行产品级 Web 服务器(比如 Apache)的配置工作。 开发服务器监测你的代码并自动加载它,修改代码时无需重启动服务,就可以查看修改结果。

切换到项目目录 (cd mysite ),运行下面的命令:

python manage.py runserver

Python开发入门与实战2-第一个Django项目

这将会在端口8000启动一个本地服务器, 并且只能从你的这台电脑连接和访问。 既然服务器已经运行起来了,现在用网页浏览器访问 http://127.0.0.1:8000/ 。 我们可以看到一个淡蓝色Django欢迎页面。

它开始工作了,如下图:

Python开发入门与实战2-第一个Django项目

2.3.Hello World页面

我们的第一个目标,是创建一个网页,用来输出这个著名的示例信息:Hello world.

如果你曾经发布过Hello world页面,但是没有使用网页框架,只是简单的在hello.html文本文件中输入Hello World,然后上传到一个网页服务器上,如:http:// 127.0.0.1/helloWorld.html

注意,这里有两个关键的信息: ①一个包括字符串 "Hello world"的页面;②页面的URL( http://127.0.0.1/helloWorld.html)。

使用Django在做网页会比较不一样,我们会用不同的方法来完成这两个关键信息。①页面的内容是靠view function(视图函数)来实现;②URL定义在urls.py文件的 URLconf配置信息里。

首先,我们先写一个关于Hello World视图函数。

第一份视图:

在上一章我们使用django-admin.py startproject创建的mysite文件夹中,我们手工创建一个叫做views.py的空文件。这个文件将包含这一章的视图定义信息。 view.py文件名为Django约定俗成,便于理解和阅读代码。

我们的Hello world视图非常简单。 是一个完整的函数和导入声明,你需要输入到views.py文件的内容如下:

from django.http import   HttpResponse

def helloworld(request):

    return HttpResponse("Hello   world")

说明:Django一个视图就是Python的一个函数。这个函数第一个参数的类型是HttpRequest;它返回一个HttpResponse实例。下面我们将使我们的第一个一个Python的函数成为一个Django可识别的视图。

2.3.1.你的第一个URLconf

我们把URLconf配置信息理解为Django网站的目录。 它的本质上是定义 URL 模式以及要为该 URL 模式调用的视图函数之间的映射表。通过这个映射表Django就可以知道,对于某个特定的URL访问,需要执行那个具体的视图函数代码。 例如,当用户访问/ helloworld /时,调用视图函数helloworld (),这个视图函数存在于Python模块文件view.py中。

前一章中执行 django-admin.py startproject 时,自动为创建了一份 URLconf(即 urls.py 文件)。 默认的urls.py会像下面这个样子:

from django.conf.urls import patterns, include, url

# Uncomment the next two lines to enable the admin:

# from django.contrib import admin

# admin.autodiscover()

urlpatterns = patterns('',

    # Examples:

    # url(r'^$',   'mysite.views.home', name='home'),

    #   url(r'^mysite/', include('mysite.foo.urls')),

    # Uncomment the   admin/doc line below to enable admin documentation:

    #   url(r'^admin/doc/', include('django.contrib.admindocs.urls')),

    # Uncomment the   next line to enable the admin:

    #   url(r'^admin/', include(admin.site.urls)),

)

我们想在URLconf中加入URL和view,只需增加映射URL模式和view功能的Python tuple即可。下面演示如何添加view中helloworld功能:

from django.conf.urls import patterns, include, url

from mysite.views import helloworld

# Uncomment the next two lines to enable the admin:

# from django.contrib import admin

# admin.autodiscover()

urlpatterns = patterns('',

    # Examples:

    # url(r'^$',   'mysite.views.home', name='home'),

    #   url(r'^mysite/', include('mysite.foo.urls')),

    # Uncomment the   admin/doc line below to enable admin documentation:

    # url(r'^admin/doc/',   include('django.contrib.admindocs.urls')),

    # Uncomment the   next line to enable the admin:

    #   url(r'^admin/', include(admin.site.urls)),

    ('^helloworld/$', helloworld),

)

保存文件,如果没有启动Django开发服务器来测试修改好的 URLconf,运行命令行 python manage.py runserver 。

如果刚才它一直运行,不需要手工重启、开发服务器会自动监测代码改动并自动重新装载新加信息。直接刷新刚才的网页http://127.0.0.1:8000/就可以看到下图:

Python开发入门与实战2-第一个Django项目

如上图,网站已经看到我们映射的网页目录。

打开你的浏览器访问 http://127.0.0.1:8000/helloworld/ 。 你就可以看到输出结果了。 开发服务器将自动检测Python代码的更改情况来做必要的重新加载。打开浏览器直接输入“http://127.0.0.1:8000/ helloworld/”,我们将看到我们创建的第一个Django视图输出的Hello world。

Python开发入门与实战2-第一个Django项目

现在我们已经成功创建了第一个Django的web页面。

2.4.小结

Django网站与原来常规的网站页面会比较大的差别,传统网站的静态页面文件,在Django框架里都变成了一个一个对应的视图函数,需要我们注意。下一章节会介绍到Django如何通过动态拼接html页面代码来实现网站页面的。本文主要为初学者提供Django入门和一些具体实践例子内容。关于更多的Django运行和装载原理,请参考《The Django Book》网站。