如何安装Django

这篇文档将会让你的Django运行起来。

安装 Python

Django作为Python的一个Web框架,当然需要Python支持。这里有详细的版本说明 What Python version can I use with Django?

到这里下载最新的Python https://www.python.org/download/ 或者到你的操作系统的软件包管理器中获取。

Django on Jython

如果你使用的是 Jython (Java平台的Python实现), 您需要执行一些额外的步骤. 参考 Running Django on Jython

Python on Windows

如果你是在Windows平台上使用Django, 这个 How to install Django on Windows 会对你很有帮助。

安装 Apache 和 mod_wsgi

如果你只是想尝试下Django,你可以直接跳到下一节;Django包括一个可以用于测试的轻量级web服务器。 因此,在您准备好部署Django之前,您不需要设置Apache。

如果您想在生产环境上使用Django, 请使用 Apachemod_wsgi。mod_wsgi提供两种模式:嵌入式模式和守护进程模式。

在嵌入模式下,mod_wsgi类似于mod_perl - 它在Apache中嵌入Python,并在服务器启动时将Python代码加载到内存中。 代码在Apache进程的整个生命周期内保留在内存中,这使其比其他服务器安排有显着的性能提升。

在守护进程模式下,mod_wsgi生成一个处理请求的独立守护进程。守护进程可以作为不同于Web服务器的用户运行, 从而可以提高安全性,并且可以重新启动守护进程,而无需重新启动整个Apache Web服务器,从而可以更加无缝地刷新代码库。

请查阅mod_wsgi文档以确定适合您的设置的模式。

有关如何在安装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, OracleSQLite.

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

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

除了数据库,您还需要确认您已经安装了数据库的操作库。

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

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

卸载旧版Django

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

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

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

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

安装Django

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

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

pip 安装官方正式版

这是安装Django的推荐方法。

  1. 安装 pip 。最简单的是使用 standalone pip installer 。如果您的发布版本已安装 pip ,您可能需要更新它, (如果它已过时,您会知道,因为安装不会正常工作。)
  2. 查看 virtualenvvirtualenvwrapper 。这些工具提供了独立的Python环境,这比在系统范围内安装包更实用。 它们还允许安装无管理员权限的软件包。这取决于你决定是否要学习和使用它们。contributing tutorial 讲述了如何在Python3上安装它们。
  3. 创建并激活虚拟环境后,在shell提示符处输入命令 pip install Django

安装特定版本

发布版本说明 中,看看你的平台/发行版是否提供官方的Django包/安装程序。 分配提供的包通常允许自动安装依赖项和升级;但是,这些包很少包含最新的Django版本。

安装开发版

Tracking Django development

如果您决定使用Django的最新开发版本,则需要密切注意 the development timeline , 并且您需要密切关注 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的代码。最方便的方法是使用 virtualenvvirtualenvwrapperpipcontributing tutorial 将介绍如何在 python3上创建一个virtualenv。

  4. 在设置和激活virtualenv之后,运行以下命令:

    $ pip install -e django/
    

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

当您想要更新Django源代码的副本时,只需在Django目录中运行命令 git pull。当您这样做时,Git将自动下载所有更改。