The Django Book 第2章【Django快速上手 】

翻译www.djangobook.com之第二章：Django快速上手

The Django Book 第2章：Django快速上手

revised by xin_wang

谢天谢地，安装Django非常容易。因为Django可以运行在任何可以运行Python的环境中，所以可以以多种方式进行配置。

在本章我们将尝试覆盖几种常见的Django安装场景。

安装Python

Django是以100%纯Python代码写就，所以你需要安装Python，Django要求安装Python2.3或更高版本。

如果你使用Linux或者MacOSX，你可能已经安装了Python

在命令行或者终端下输入“python”，如果出现类似如下提示，表示Python已经安装好了：

Python 2.4.1 (#2, Mar 31 2005, 00:05:10)

[GCC 3.3 20030304 (Apple Computer, Inc. build 1666)] on darwin

Type "help", "copyright", "credits" or "license" for more information.

>>>

否则，出现错误提示“command not found”

你可以到http://www.python.org/download/下载Python安装

安装Django

安装官方发布版本的Django

到http://www.djangoproject.com/download/下载tarball的Django-*.tar.gz

tar xzvf Django-*.tar.gz
cd Django-*
sudo python setup.py install

Windows下安装则是直接解压Django-*.tar.gz并运行python setup.py install

安装完以后，在Python交互环境下应该可以import django模块

>>> import django
>>> django.VERSION
(1, 0, 'official')

Python交互环境是一个命令行程序，在命令行下运行“python”即可进入交互环境

在这本书里，我们将会演示一些Python代码例子，这些例子看起来像是在交互环境里面输入的。

Python交互环境的提示符是三个大于号(>>>)

从Subversion安装Django

如果你想安装Django最新代码或者你想向Django贡献代码，你应该从Django的Subversion repository安装

Subversion是一个与CVS类似的开源版本控制系统，Django团队使用它来管理Django代码的变化。

你可以随时使用Subversion客户端获取最新的Django源代码，或者更新你本机Subversion工作拷贝"local checkout"中的

Django代码来获得Django开发人员所作的最新修改和增强。

最新的Django开发代码称为“the trunk”

得到最新的Django trunk：

1，确认你安装了Subversion客户端，下载地址为http://subversion.tigris.org

Subverion的文档http://svnbook.redbean.com

2，运行如下命令得到trunk“svn co http://code.djangoproject.com/svn/django/trunk django_src”

3，符号链接django_src/django来让django在你的Python site-packages目录下，或者更新PYTHONPATH指定它

从Subversion安装不需要运行“python setup.py install”

Django trunk经常更新bug fixs和增加feature，你可能要频繁更新它

在django_src目录下运行“svn update”即可更新代码

建立数据库

Django仅有的先决条件就是安装Python，但是本书关注Django引以为傲的众多优点之一，开发支持数据库的Web站点

所以你需要安装一个数据库服务器来存储数据

如果你只是想浅尝辄止，可以跳过这一步直接开始一个项目，可是请相信我们：你最终还是会装一个数据库，因为本书的

所有例子都假设你已经拥有一个数据库

Django1.0支持5个数据库引擎：

PostgreSQL(http://www.postgresql.org/)

SQLite 3(http://www.sqlite.org/)

MySQL(http://www.mysql.com/)

Microsoft SQL Server(http://www.microsoft.com/sql/)

Oracle(http://www.oracle.com/database/)

我们自己特别喜欢PostgreSQL，所以我们最先提到它

尽管如此，所有的这些数据库都在Django上工作得都很好

SQLite也值得特别注意，它是一个非常简单的数据库引擎，不需要任何服务器安装和配置

如果你只是想玩玩Django的话，SQLite是最容易安装的

使用PostgrSQL来和Django工作

如果你用PostgreSQL，你需要psycopg包，从http://initd.org/projects/psycopg1可以得到

确认你使用版本1而不是版本2，2还是beta版

如果你在Windows上使用PostgreSQL，可以从如下地址下载已经编译好的二进制psycopg
http://stickpeople.com/projects/python/win-psycopg/

使用SQLite 3来和Django工作

你需要SQLite 3而不是SQLite 2，从http://initd.org/tracker/pysqlite下载pysqlite

确认下载pysqlite的版本为2.0.3及以上

使用MySQL来和Django工作

Django需要MySQL版本4.0及以上，3.x版本不支持事务、嵌套存储过程以及其它标准SQL语句

你也需要MySQLdb包，下载地址http://sourceforge.net/projects/mysql-python

使用MSSQL来和Django工作

使用Oracle来和Django工作

不使用数据库来和Django工作

就像刚刚提到的，Django实际上不需要数据库

如果你仅仅希望Django来提供动态网页而不触及数据库也是可以的

和Django绑定的一些额外的工具需要数据库，如果你选择不使用数据库，你会错失那些特性

开始一个项目

如果这是你第一次使用Django，你必须注意一些初始化过程

运行“django-admin.py startproject mysite”将会在你的当前目录下创建一个mysite目录

注意，如果你使用setup.py安装Django，django-admin.py应该在你的PATH系统变量下

如果不在PATH里面，你可以从site-packages/django/bin找到它

考虑符号链接它到你的PATH里面，例如/usr/local/bin

一个项目就是一个Django实例的设置的集合，包括数据库配置、Django的专有设置以及应用程序专有设置

让我们看看startproject创建了什么：

/mysite/

__init__.py

manage.py

settings.py

urls.py

这些文件的说明如下：

manage.py

一个命令行工具，可以让你以多种方式与Django项目交互

setting.py

Django项目的配置

urls.py

Django项目的URL定义

如果你使用PHP，你可能习惯于将代码放在Web服务器的document root下，如/var/www

使用Django的话不要这样做，将Python代码放在document root下不是一个好主意

因为这样的话人们可能从Web看到你的代码，这并不安全

把你的代码放在document root以外的目录，如/home/mycode

开发用服务器

切换到mysite目录，运行“python manage.py runserver”，你将看到如下信息

Validating models...

0 errors found.

Django version 1.0, using settings 'mysite.settings'

Development server is running at http://127.0.0.1:8000/

Quit the server with CONTROL-C.

这样你就启动了Django开发用服务器，这是一个包含在Django中的开发阶段使用的轻量级Web服务器

我们在Django中包含了这个服务器是为了快速开发，这样在产品投入应用之前，就可以不用处理生产环境中

web server的配置工作了。

这个服务器查看你的代码，如果有改动，它自动reload，让你不需重启快速修改你的项目

虽然这个开发用服务器对于开发来说简直棒透了，还是请克制一下把它用在任何形式的生产环境中的冲动。

这个服务器一次只能可靠地处理一个请求，而且根本没有经过任何安全性的检验

如果你的站点需要上线，请参考第21章的关于部署Django程序的介绍

默认情况下runserver命令启动服务器的端口为8000，只监听本地连接

如果你希望改变端口，增加一个命令行参数即可

python manage.py runserver 8080

你也可以改变服务器监听的IP地址，当你同其它开发者分享一个开发站点时很有用

python manage.py runserver 0.0.0.0:8080
上面的命令使得Django监听任何网络接口，这样的话就允许其它计算机连接该服务器

试着访问http://127.0.0.1:8000/，你将会看到“Welcome to Django”的页面

下一步是什么？

我们已经安装好一切的东西并且让服务器运行了，让我们写一点基本代码来展示怎样使用Django提供动态页面