编写你的第一个Django应用

安装 Python

做为一个 Python Web 框架,Django 须要 Python。更多细节请参见 我应该使用哪一个版本的 Python 来配合 Django?html

Python 包含了一个名为 SQLite 的轻量级数据库,因此你暂时没必要自行设置一个数据库。python

最新版本的 Python 能够经过访问 https://www.python.org/downloads/ 或者操做系统的包管理工具获取。linux

你能够在你的 shell 中输入 python 来肯定你是否安装过 Python;你看到的多是像这样子web

Python 3.x.y [GCC 4.x] on linux Type "help", "copyright", "credits" or "license" for more information. >>>

设置数据库

此步骤仅在你打算使用诸如 PostgreSQL, MySQL, 或者 Oracle 这些大型数据库引擎时须要。要安装这种数据库, 请参考 database installation information正则表达式

安装 Django

你有三个简单的方法来安装 Django:sql

验证

若要验证 Django 是否能被 Python 识别,能够在 shell 中输入 python。 而后在 Python 提示符下,尝试导入 Django:shell

>>> import django
>>> print(django.get_version())
2.1

固然了,你也可能安装的是其它版本的 Django。


编写你的第一个 Django 应用

它将由两部分组成:数据库

  • 一个让人们查看和投票的公共站点。
  • 一个让你能添加、修改和删除投票的管理站点。

咱们假定你已经阅读了 安装 Django。你能知道 Django 已被安装,且安装的是哪一个版本,经过在命令提示行输入命令(由 $ 前缀)。django

$ python -m django --version

若是这行命令输出了一个版本号,证实你已经安装了此版本的 Django;若是你获得的是一个“No module named django”的错误提示,则代表你还未安装。bootstrap

这个教程是为了 Django 2.1 写的,它支持 Python 3.5 和后续版本。若是 Django 的版本不匹配,你能够经过页面右下角的版本切换器切换到对应你版本的教程,或更新至最新版本。若是你正在使用一个较老版本的 Python,在 我应该使用哪一个版本的 Python 来配合 Django? 查找一个合适的 Django 版本。

你能够查看文档 如何安装 Django 来得到关于移除旧版本,安装新版本的流程和建议。

 

建立项目

若是这是你第一次使用 Django 的话,你须要一些初始化设置。也就是说,你须要用一些自动生成的代码配置一个 Django project —— 即一个 Django 项目实例须要的设置项集合,包括数据库配置、Django 配置和应用程序配置。

打开命令行,cd 到一个你想放置你代码的目录,而后运行如下命令:

$ django-admin startproject mysite

这行代码将会在当前目录下建立一个  目录。若是命令失败了,查看 运行``django-admin``时遇到的问题,可能能给你提供帮助。

让咱们看看  建立了些什么:

mysitestartproject
mysite/ manage.py mysite/ __init__.py settings.py urls.py wsgi.py

这些目录和文件的用处是:

  • 最外层的:file: mysite/ 根目录只是你项目的容器, Django 不关心它的名字,你能够将它重命名为任何你喜欢的名字。
  • manage.py: 一个让你用各类方式管理 Django 项目的命令行工具。你能够阅读 django-admin and manage.py 获取全部 manage.py 的细节。
  • 里面一层的 mysite/ 目录包含你的项目,它是一个纯 Python 包。它的名字就是当你引用它内部任何东西时须要用到的 Python 包名。 (好比 mysite.urls).
  • mysite/__init__.py:一个空文件,告诉 Python 这个目录应该被认为是一个 Python 包。若是你是 Python 初学者,阅读官方文档中的 更多关于包的知识
  • mysite/settings.py:Django 项目的配置文件。若是你想知道这个文件是如何工做的,请查看 Django settings 了解细节。
  • mysite/urls.py:Django 项目的 URL 声明,就像你网站的“目录”。阅读 URL调度器 文档来获取更多关于 URL 的内容。
  • mysite/wsgi.py:做为你的项目的运行在 WSGI 兼容的Web服务器上的入口。阅读 如何使用 WSGI 进行部署 了解更多细节。

确认一下你的 Django 项目是否真的建立成功了。若是你的当前目录不是外层的 mysite 目录的话,请切换到此目录,而后运行下面的命令:

$ python manage.py runserver

 

刚刚启动的是 Django 自带的用于开发的简易服务器,它是一个用纯 Python 写的轻量级的 Web 服务器。咱们将这个服务器内置在 Django 中是为了让你能快速的开发出想要的东西,由于你不须要进行配置生产级别的服务器(好比 Apache)方面的工做,除非你已经准备好投入生产环境了。

如今是个提醒你的好时机:千万不要 将这个服务器用于和生产环境相关的任何地方。这个服务器只是为了开发而设计的。(咱们在 Web 框架方面是专家,在 Web 服务器方面并非。)

如今,服务器正在运行,浏览器访问 https://127.0.0.1:8000/。你将会看到一个“祝贺”页面,随着一只火箭发射,服务器已经运行了。

 

建立投票应用

应用能够存放在任何 Python path 中定义的路径。在这个教程中,咱们将在你的 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 HttpResponse def index(request): return HttpResponse("Hello, world. You're at the polls index.")

这是 Django 中最简单的视图。若是想看见效果,咱们须要将一个 URL 映射到它——这就是咱们须要 URLconf 的缘由了。

为了建立 URLconf,请在 polls 目录里新建一个 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 path from . import views urlpatterns = [ path('', views.index, name='index'), ]

下一步是要在根 URLconf 文件中指定咱们建立的  模块。在  文件的 列表里插入一个 , 以下:

polls.urlsmysite/urls.pyurlpatternsinclude()
mysite/urls.py
from django.contrib import admin from django.urls import include, path urlpatterns = [ path('polls/', include('polls.urls')), path('admin/', admin.site.urls), ]

ali-4c327595919b:PycharmProjects drizzle$ tree django/
django/
└── mysite
├── db.sqlite3
├── manage.py
├── mysite
│   ├── __init__.py
│   ├── __pycache__
│   │   ├── __init__.cpython-36.pyc
│   │   ├── settings.cpython-36.pyc
│   │   ├── urls.cpython-36.pyc
│   │   └── wsgi.cpython-36.pyc
│   ├── settings.py
│   ├── urls.py
│   └── wsgi.py
└── polls
├── __init__.py
├── __pycache__
│   ├── __init__.cpython-36.pyc
│   ├── urls.cpython-36.pyc
│   └── views.cpython-36.pyc
├── admin.py
├── apps.py
├── migrations
│   └── __init__.py
├── models.py
├── tests.py
├── urls.py
└── views.py

 

函数 include() 容许引用其它 URLconfs。每当 Django 遇到 :func:~django.urls.include 时,它会截断与此项匹配的 URL 的部分,并将剩余的字符串发送到 URLconf 以供进一步处理。

咱们设计 include() 的理念是使其能够即插即用。由于投票应用有它本身的 URLconf( polls/urls.py ),他们可以被放在 "/polls/" , "/fun_polls/" ,"/content/polls/",或者其余任何路径下,这个应用都可以正常工做。

 

如今把 index 视图添加进了 URLconf。能够验证是否正常工做,运行下面的命令:

 

$ python manage.py runserver

用你的浏览器访问 http://localhost:8000/polls/,你应该可以看见 "Hello, world. You're at the polls index." ,这是你在  视图中定义的。

测试结果index

 

 
      
 
 
 
 

 





 

 

 

 

Linux下安装Django

  Django是基于Python开发的免费的开源网站框架,也是python web开发中重量级的web框架,能够用于快速搭建高性能而且优雅的网站!

  下面以Fedora为例安装Django,最新Fedora 23集成了python 3.4.3,因此能够直接安装django,同时建议不要使用本身编译安装的python来安装django,这样可能会出问题,由于不少东西要依赖于系统自己,本身编译安装的python只用来开发本地应用,而不是web开发;另外在Fedora中,输入python会提示命令找不到,而输入python3会进入python交互式界面,那是由于/usr/bin/下只有python3软连接,连接到python3.4,而并无python这个连接,因此为了后来方便,咱们能够创建一个软连接python,不用每次都再输python3了,命令以下:

ln -s /usr/bin/python3 /usr/bin/python

  这样就创建了一个软连接,之后随时输入python便可了,好的,下面正式的开始安装Django

  安装django以前,首先要安装pip,pip是一种相似yum这样的软件安装工具,用它能够很方便的安装软件,而且自动解决版本升级问题,实际上pip是专门安装和管理python包的工具,是easy_install的替代品,因此要先安装pip,pip的在python官网的连接是:https://pypi.python.org/pypi/pip/

  进去上述网站以后,点击Installation就能够进入安装说明界面了,网址是:https://pip.pypa.io/en/latest/installing/

  

  紧接着咱们就看到,pip的安装方法之一就是使用get-pip.py脚原本安装,咱们能够复制get-pip.py的连接,也能够先下载到本地计算机上而后上传至服务器,能够看到get-pip.py的连接是:https://bootstrap.pypa.io/get-pip.py

  执行下面命令下载该文件:

wget https://bootstrap.pypa.io/get-pip.py

  下载完以后,根据官网说明,要使用本地的python运行该脚本:

python get-pip.py

  稍等一下pip就安装成功了,能够经过执行的pip命令查看对应的参数,下面使用pip来安装django,django官网有详细的教程:https://www.djangoproject.com/,根听说明知道,安装django的命令是:pip install Django,这样运行默认安装的是最新版,目前是1.9.2,由于python版本的缘由,因此会出现错误,安装失败,根据测试在python3.4基础上安装Django 1.8.9正式版是没有问题的,因此要执行下面命令:

pip install Django==1.8.9

  回车后稍等一会,须要下载相应的文件,等执行完毕,Django 1.8.9就安装成功了,若是是CentOS 6.6或者更低版本,系统上带的python版本是2.6.6,那么通过测试安装Django 1.5.8是没有任何问题的因此用pip应该是:pip install Django==1.5.8

  等安装完成以后,执行python进入交互式界面,输入import django,而后再输入django.VERSION回车后能够看到刚刚安装的Django的版本号,或者直接执行下面命令:

python -c "import django; print(django.get_version())"

  这同时也说明django安装成功了

  接下来能够开始建立web应用了,在咱们的根目录下随便建立一个目录,用来专门放置Django项目,在该目录下执行下面命令:

django-admin.py startproject HelloDjango

  这就是建立django项目的命令,使用pip安装django后,在/usr/bin/下会生成django-admin.py新版本中也会生成django-admin可执行文件,因此也能够执行:django-admin startproject HelloDjango建立项目,建立后咱们进入项目目录:

cd HelloDjango/

  进入目录以后,能够经过tree命令查看目录结构,若是提示没有tree命令的话,可使用yum -y install tree命令来安装

  

  咱们能够看到初始目录的文件了,项目目录下manage.py是一个实用的命令行工具,能够经过它管理django服务器等,容器下还有一个和容器同名的HelloDjango目录,__init__.py是项目初始化文件,告诉python该目录是一个python包,settings.py是用来进行项目配置的文件,urls.py是项目中全部的url声明,能够认为是django驱动整个项目的url目录,能够定义多种优雅的路由请求,wsgi.py是一个WSGI兼容的Web服务器入口,方便运行web项目。如今这就是一个初始的项目,咱们接下来启动这个项目:

python manage.py runserver 主机ip:80

  由于要从局域网访问因此后面咱们本身定义的是服务器自己的ip和端口号,启动以后命令行进入等待,访问以前不要忘了关闭防火墙,对于centos可使用以下命令关闭:

/etc/init.d/iptables stop

  对于我如今使用的Fedora,关闭命令是:

/bin/systemctl stop firewalld.service

  关闭防火墙以后,咱们经过浏览器访问http://hostIP/便可以打开页面,

  看到这个页面说明django运行一切正常了,浏览器每发出请求,服务器都会更新消息:

  

  经过Ctrl+C快捷键能够终止服务器,接下来咱们新建一个简单的测试应用,能够在HelloDjango下直接创建视图文件,可是为了应用结构的清晰不建议这样作,正确方法是在容器根目录下,使用以下命令能够创建一个应用,一个项目能够包括多个应用:

python manage.py startapp app1

  这样在容器下就会出现一个app1的目录,结构以下:

  

  每一个源文件的含义也不难理解,下面使用vim打开views.py,若是没有vim可使用yum install vim进行安装 

  打开后views.py是空的,有用的只有头部一行代码,是用于后来模板渲染的

  

  如今咱们直接补充以下代码,打印一行简单的输出:

from django.http import HttpResponse

def index(request):
    return HttpResponse("Hello Django!")

  头部包含了请求库,每一个方法都必须有request参数,这是用来接收请求的,HttpResponse方法的做用就是响应请求,而后保存视图文件,进入项目下的HelloDjango目录,编辑settings.py配置文件,找到INSTALLED_APPS配置项,追加一项app1,将应用app1添加到项目容器

  

  保存以后,编辑urls.py文件,头部追加一行from app1 import views as app1_views,这个app_views是咱们本身定义的导入的视图名,而后给urlpatterns这个列表添加一项:url(r'^$', app1_views.index),  注意后面要有一个逗号,前面是定义请求url的正则表达式,后面是响应输出的视图方法,这里正则表达式匹配为空,就是表明的根目录,以下图,带有# new注释的是新增的代码:

  

  如今保存,回到容器下再次运行:python manage.py runserver hostip:80启动开发服务器,用浏览器访问便可

  

  下面能够在以前的视图中再定义一个方法,

def home(request):
    return render(request, 'home.html')

  使用render方法以前要使用from django.shortcuts import render导入对应库,由于前面默认导入了因此不用再次导入了,render方法的做用就是调用对应的视图模板也就是home.html,那么home.html放到什么地方呢,在app1目录下执行下面命令:

$ mkdir templates
$ cd templates/
$ vim home.html

  在django加载app1应用时,会自动读取templates模板目录从而渲染里面的数据,home.html就是一个网页模板,为了简单,没有添加动态的数据:

按 Ctrl+C 复制代码

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>home视图</title>
</head>
<body>
<h3>Hello Django!</h3>
</body>
</html>


按 Ctrl+C 复制代码

  一样添加urls.py的配置项,设置访问url,代码就是下图列表中的第三项:

  

  保存后,一样启动服务器,访问http://hostip/home就能够看到对应的响应

  

  以上就是Django基本的安装和最简单的例子。

相关文章
相关标签/搜索