Skip to main content

如何安装Django

这个文件将让你和运行Django。

安装Python

作为一个Python Web框架,Django需要Python。有关详细信息,请参阅 什么Python版本可以与Django一起使用?

https://www.python.org/download/ 或使用操作系统的包管理器获取最新版本的Python。

Django上的Jython

如果使用 Jython (Java平台的Python实现),则需要执行几个附加步骤。有关详细信息,请参阅 在Jython上运行Django

Python上的Python

如果你刚刚开始与Django和使用Windows,你可能会发现 如何在Windows上安装Django 有用。

安装Apache和 mod_wsgi

如果你只是想试验Django,请跳到下一节; Django包括一个可以用于测试的轻量级Web服务器,因此您不需要设置Apache,直到您准备好在生产环境中部署Django。

如果您想在生产站点上使用Django,请将 Apachemod_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的信息,请参阅 如何使用Django与mod_wsgi

如果你不能使用mod_wsgi由于某种原因,恐怕不:Django支持许多其他部署选项。一个是 uWSGI;它与 nginx 非常好。此外,Django遵循WSGI规范(PEP 3333),允许它在各种服务器平台上运行。

使您的数据库运行

如果您打算使用Django的数据库API功能,您需要确保数据库服务器正在运行。 Django支持许多不同的数据库服务器,并正式支持 PostgreSQLMySQLOracleSQLite

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

除了官方支持的数据库,还有 后端由第三方提供 允许您使用其他数据库与Django。

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

  • 如果你使用PostgreSQL,你需要 psycopg2 包。有关详细信息,请参阅 PostgreSQL注释

  • 如果你使用MySQL,你将需要一个 DB API驱动程序mysqlclient。有关详细信息,请参阅 笔记为MySQL后端

  • 如果你使用SQLite,你可能想阅读 SQLite后端注释

  • 如果您使用Oracle,则需要一份 cx_Oracle 副本,但有关Oracle和 cx_Oracle 的受支持版本的详细信息,请阅读 Oracle后端的注释

  • 如果您使用非官方的第三方后端,请参阅为其他任何要求提供的文档。

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

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

删除任何旧版本的Django

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

如果您以前使用 pipeasy_install 安装Django,再次安装 pipeasy_install 将自动处理旧版本,因此您不需要自己去做。

如果您以前使用 python setup.py install 安装了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环境,这比在系统范围内安装包更实用。他们还允许安装没有管理员权限的软件包。 贡献教程 将介绍如何在Python 3上创建virtualenv。

  3. 创建并激活虚拟环境后,在shell提示符处输入命令 pip install Django

安装特定于分发包的软件包

检查 分配特定注释 以查看您的平台/发行版是否提供了官方的Django软件包/安装程序。分发提供的包通常将允许自动安装依赖项和容易的升级路径;然而,这些包很少包含最新版本的Django。

安装开发版本

跟踪Django开发

如果你决定使用Django的最新开发版本,你需要密切关注 the development timeline,你需要关注 发布说明即将发布。这将帮助您留住您可能想使用的任何新功能,以及更新您的Django副本时,您需要对您的代码进行任何更改。 (对于稳定版本,任何必要的更改都记录在发行说明中。)

如果您希望能够随时更新您的Django代码,并提供最新的错误修正和改进,请按照以下说明操作:

  1. 确保您已安装 Git,并且您可以从shell运行其命令。 (在shell提示符下输入 git help 来测试这个。)

  2. 检查Django的主要开发分支,如:

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

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

  3. 确保Python解释器可以加载Django的代码。最方便的方法是使用 virtualenvvirtualenvwrapperpip贡献教程 将介绍如何在Python 3上创建virtualenv。

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

    $ pip install -e django/
    

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

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