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提供动态页面