如何安装Django框架

这份文档将会带领你使用Django框架

安装 Python

开始一个Python Web 框架, Django 需要依赖 Python环境. 看到 Django可以使用什么Python版本？ 详细信息。

在https://www.python.org/downloads/或您的操作系统的软件包管理器获取最新版本的Python。

Django上的Jython

如果您使用Jython（Java平台的Python实现），则需要执行几个其他步骤。 有关详细信息，请参见Running Django on Jython。

Windows上的Python

如果你刚刚开始使用Django和使用Windows，你可能会发现How to install Django on Windows很有用。

安装Apache和mod_wsgi

如果您只想尝试Django，请跳过到下一节； Django包含一个可用于测试的轻量级Web服务器，因此，在准备好在生产中部署Django之前，您将不需要设置Apache。

如果您想在生产网站上使用Django，请使用Apache和mod_wsgi。 mod_wsgi可以以两种模式之一操作：嵌入式模式和守护进程模式。 在嵌入模式下，mod_wsgi类似于mod_perl - 它在Apache中嵌入Python，并在服务器启动时将Python代码加载到内存中。 代码在Apache进程的整个生命周期内保留在内存中，这使得比其他服务器安排有显著的性能提升。 在守护进程模式下，mod_wsgi生成一个处理请求的独立守护进程。 守护进程可以作为不同于Web服务器的用户运行，从而可以提高安全性，并且可以重新启动守护进程，而无需重新启动整个Apache Web服务器，从而可以更加无缝地刷新代码库。 请查阅mod_wsgi文档以确定适合您的设置的模式。 确保您已安装Apache，并且已激活mod_wsgi模块。 Django将与支持mod_wsgi的任何版本的Apache一起工作。

有关如何在安装mod_wsgi之后配置mod_wsgi的信息，请参阅How to use Django with mod_wsgi。

如果你出于某种原因不能使用mod_wsgi，不要害怕：Django支持许多其他部署选项。 一个是uWSGI；它同样契合nginx。 此外，Django遵循WSGI规范（ PEP 3333），这允许它在各种服务器平台上运行。

让你的数据库运行起来

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

如果您正在开发一个简单的项目或者您不打算在生产环境中部署，SQLite通常是最简单的选项，因为它不需要运行单独的服务器。 但是，SQLite与其他数据库有很多不同之处，因此如果您正在处理大量的工作，建议您使用与生产中使用的数据库相同的数据库进行开发。

除了官方支持的数据库之外，还有由第三方提供的backends provided by 3rd parties允许您使用其他数据库与Django。

除了数据库后端，您还需要确保安装了Python数据库绑定。

如果您计划使用Django的manage.py migrate命令为模型自动创建数据库表（在首次安装Django并创建项目之后） ，您需要确保Django具有在您使用的数据库中创建和更改表的权限；如果您打算手动创建表格，只需授予Django INSERT，DELETE，UPDATE和SELECT权限即可。 使用这些权限创建数据库用户后，您将在项目的设置文件中指定详细信息，有关详细信息，请参阅DATABASES。

如果您使用Django的testing framework测试数据库查询，Django将需要创建测试数据库的权限。

删除旧版本的Django

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

如果以前使用pip或easy_install安装了Django，则再次使用pip或easy_install安装会自动处理旧版本，所以你不需要自己做。

如果您以前使用python setup.py 安装安装了Django，卸载操作就像删除site-packages目录从您的Python django。 要找到需要删除的目录，可以在shell提示符下运行以下命令（而不是交互式Python提示符）：

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

安装Django代码

安装说明稍有不同，具体取决于是安装特定于发行版的软件包，下载最新的正式版本还是获取最新的开发版本。

这很容易，无论你选择哪种方式。

使用pip安装正式版本

这是安装Django的推荐方法。

  1. 安装pip。 最简单的是使用独立pip安装程序。 如果您的发布版本已安装pip，您可能需要更新它，如果它已过时。 如果它已经过时，你会知道，因为安装将不起作用。
  2. 看看virtualenv和virtualenvwrapper。 这些工具提供了孤立的Python环境，这比在系统范围内安装包更实用。 它们还允许安装无管理员权限的软件包。 contributing tutorial将介绍如何在Python 3上创建一个virtualenv。
  3. 在创建并激活虚拟环境之后，在shell提示符下输入命令pip install Django。

安装特定于发行版的软件包

检查特定发行版说明，看看您的平台/发行版是否提供了官方的Django包/安装程序。 分发提供的包通常将允许自动安装依赖项和容易的升级路径；但是，这些包很少包含最新版本的Django。

安装开发版本

跟踪Django开发

如果您决定使用Django的最新开发版本，则需要密切注意开发时间线，并且您需要密切关注release notes for the upcoming release。 这将帮助您保持任何您可能想要使用的新功能，以及更新您的Django的副本，您需要对您的代码进行任何更改。 （对于稳定版本，任何必要的更改都记录在版本说明中。）

如果您希望偶尔更新Django代码，并提供最新的错误修正和改进，请按照以下说明操作：

  1. 请确保您已安装Git，并且可以从shell运行其命令。 （在shell提示符下输入git help以测试此操作。

  2. 查看Django的主要开发部门，如下所示：

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

    这将在当前目录中创建一个目录django。

  3. 确保Python解释器可以加载Django的代码。 最方便的方法是使用virtualenv，virtualenvwrapper和pip。 contributing tutorial将介绍如何在Python 3上创建一个virtualenv。

  4. 设置并激活virtualenv后，运行以下命令：

    $ pip install -e django/

    这将使Django的代码可以导入，并且还会使django-admin实用程序命令可用。 换句话说，你已经准备好了！

当你想更新你的Django源代码副本时，只需在django目录中运行命令git pull。 当你这样做，Git会自动下载任何更改。