Django教程之十-----如何安装Django

这个文档将会是你获取并运行Django。

1. 安装Python

作为一个Python web框架，Django需要python。阅读<使用Django我能使用哪里Python版本>查看更多明细。

获取最新的Python版本，可以访问http://www.python.org/downloads/或者你操作系统的包管理器。

在Jython上的Django

如果你使用Jython（java平台的python实现），你将需要一些额外的步骤。阅读<在Jython上运行Django>来查看更多明细。

在Windows上使用Python

如果你使用Windows来开始Django，你将会发现<如何在Windows下安装Django>更有用

2. 安装Apache和mod_wsgi

如果你只想体验Django，跳到下一节；Django包括一个轻量级的web服务，你可以用来测试，所以你不需要去安装Apache除非你准备在Django下生产。

如果你想使用Django在生产站点上，使用带有mod_wsgi的Apache。mod_wsgi能在2种模式中进行操作：内嵌模式和守护进程模式。在内嵌模式，mod_wsgi和mod_perl很像 -- 它将Python嵌入到Apache中并且在服务启动的时候将Python代码加载到内存中。代码在Apache进程的整个生存周期都存在于内存中，这将带来显著的性能的提升，和其他服务器相比。在守护进程模式，mod_wsgi产生一个独立的守护进程来处理请求。守护进程可以作为一个不同的用户来运行，而不是web服务，可能提升安全性，而且守护进程不需要重启整个Apache Web服务就能重启，是你能无缝刷新你的代码库。查阅mod_wsgi文档来决定你要安装那个模式。确保你安装了Apache，带有mod_wsgi模块激活的。Django能在支持mod_wsgi的任何Apache版本上工作。

阅读<如何使用带mod_wsgi的Django>来获取信息关于你安装之后如何进行配置。

如果因为某些原因不能使用mod_wsgi，不用害怕：Django支持很多其他的开发选项。一个就是uWSGI;它和nginx一起工作的非常好。额外的，Django遵循WSGI说明(PEP 3333),这个允许它运行在多个服务平台上。

3. 让你的数据库运行起来 

如果你计划使用Django的数据库API功能，你将需要确保数据库服务是运行着的。Django支持许多不同的数据库服务，并且正式的被PostgreSQL，MySQL，Oracle和SQLite支持。

如果你正在开发一个小的项目或者一些你不想在生产环境下开发的，SQLite就是通常最简单的选择，因为它不需要运行一个单独的服务。然后SQLite和其他的数据有很多不同，因此，如果你正在进行一些实质性的工作，在生产中使用你希望的数据库时推荐的。

额外的对于官方支持的数据，<第3方提供的后端>允许你在Django中使用其他的数据库。

额外的对于一个数据库后端，你将需要确保你的Python数据库绑定安装好了。

• 如果你在使用PostgreSQL，你将需要psycopg2包。参考<PostgreSQL注意事项>来获取更多细节。
• 如果你使用MySQL，你将需要一个<DB API driver>像mysqlclient。查阅<MySQL后端的注意事项>来获取更多细节。
• 如果你使用SQLite，你也许想要看看<SQLite后端注意事项>
• 如果你使用一个非官方第3方后端，请参阅提供任何额外需求的文档。

如果你计划使用Django的manage.py migrate命令来自动为你的模型创建数据库表（在首先安装Django和创建项目后），你需要确保Django在你正在使用的数据库中允许你创建和修改表；如果你计划手工创建表，你只需要手工的授予Django SELECT,INSERT,UPDATE和DELETE权限。当创建了一个有这些权限的数据库用户后，你将在你项目的设置文件中指定这些细节，阅读<数据库>获取更多细节。

如果你正在使用Django的测试框架来测试数据库查询，Django将需要创建测试数据库的权限。

4. 移除任何老版本Django

如果你正在升级以前版本的Django安装，你将需要在安装新版本之前卸载旧的Django版本。

如果你之前使用pip或者easy_install安装的Django，再次使用pip或easy_install将会自动管理旧的版本，所以你不需要自己来动手。

如果你之前使用python setup.py install安装Django，卸载就如从你的Python的site-packages中删除django路径一样简单。为了找到你想要移除的路径，你可以在你的shell提示符下运行下列命令(不是交互的Python提示符)：

$ python -c "import django; print(django.__path__)"

123

5. 安装Django代码

安装指南稍微有点不同，取决于是否你安装一个发布的包，下载最新的官方发布版，或者喜欢最新的开发版。

不管你选择哪个，它都很容易。

5.1 使用pip安装一个官方发布版

这是推荐安装Django的方式。

1. 安装pip。最简单的方法是使用standalone pip installer。如果你的发型版已经安装了pip，如果他过时了你可能想要更新它。如果它过时了，你将会了解因为安装不会继续下去。
2. 看下virtualenv和virtualenvwrapper。这些工具提供独立的Python环境，这笔安装包系统更实际。他们也允许在没有管理员的权限下安装包。<特约教程>提供了如何在Python 3中创建一个virtualenv。
3. 当你创建并激活了一个virtual环境，在shell提示符下输入pip install Django命令。

5.2 安装一个指定发布的包

检查<指定发布注意事项>来了解是否你的平台/发布版提供官方的Django 包/安装器。发布版提供的包允许自动安装依赖项和简易升级路径；然而，这些包将很少包含Django的最新发布版。

5.3 安装开发版

跟踪Django开发

如果你决定使用最新的Django开发版本，你将要更多注意开发时间表，你也同时要注意即将发布的注意事项。这将帮助你在任何你想要使用的新特性上保持领先，同样当更新你的Django备份时你需要对你代码做的任何改变。（对于稳定发布版，任何必须的改变都在发布版注意事项的文档中）

如果你想能不定期的升级你的Django代码来修复最新的bug和提升，参看下面的指导：

1. 确保你安装了Git，并且你能在shell中运行它的命令(在shell提示符下输入git help来测试这一点)
2. 像这样检查Django的主要发展分支：

   $ git clone git://github.com/django/django.git

   这将在你当前路径下创建一个django路径
3. 确保Python解释器能加载Django代码。最方便的做法就是使用virualenv，virtualenvwrapper，和pip。<特约教程>提供了如何在Python 3下创建一个virtualenv.
4. 当安装和激活一个virtualenv后，运行下列命令：

   $ pip install -e django/

   123这将会让Django的代码可输入，并且是django-admin组件命令可用。换句话说，你都设置OK了！

当你想要更新你的Django源代码备份，只要在django路径裕兴命令git pull。当你这样做时，git将自动下载任何改变的东西。