如何安装Django

本文档将帮助您启动并与Django一起运行。

安装Python

Django是一个Python Web框架。看见 我可以在django中使用什么python版本? 了解更多细节。

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

Windows上的python

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

安装Apache和 mod_wsgi

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

如果您想在生产站点上使用Django,请使用 Apache 使用 mod_wsgi 。Mod_WSGI以两种模式之一运行:嵌入式模式或守护程序模式。在嵌入式模式下,mod_wsgi类似于mod_perl--它将Python嵌入到Apache中,并在服务器启动时将Python代码加载到内存中。代码在整个Apache进程的生命周期中都保留在内存中,与其他服务器配置相比,这会带来显著的性能提升。在守护程序模式下,mod_wsgi会产生一个处理请求的独立守护程序进程。守护程序进程可以以与Web服务器不同的用户身份运行,这可能会提高安全性。无需重新启动整个ApacheWeb服务器即可重新启动守护进程,这可能会更加无缝地刷新代码库。请参考mod_wsgi文档以确定哪种模式适合您的设置。确保您已经安装了激活了mod_wsgi模块的Apache.Django可以在任何支持mod_wsgi的apache版本上运行。

How to use Django with mod_wsgi 有关安装mod wsgi后如何配置mod wsgi的信息。

如果出于某种原因您不能使用mod wsgi,请不要担心:Django支持许多其他部署选项。一个是 uWSGI ;它与 nginx . 此外,Django遵循wsgi规范 (PEP 3333 ,允许它在各种服务器平台上运行。

使数据库运行

如果计划使用Django的数据库API功能,则需要确保数据库服务器正在运行。Django支持许多不同的数据库服务器,并通过 PostgreSQL, MariaDB, MySQL, OracleSQLite.

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

除了官方支持的数据库外,还有 backends provided by 3rd parties 这使您可以在Django中使用其他数据库。

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

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

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

安装Django代码

安装说明略有不同,这取决于您是安装特定于发行版的软件包、下载最新的官方版本,还是获取最新的开发版本。

安装官方版本 pip

这是安装Django的推荐方法。

  1. 安装 pip. 最简单的是使用 standalone pip installer . 如果您的发行版已经 pip 已安装,如果它过时,您可能需要更新它。如果它过时了,你就会知道,因为安装不起作用。

  2. 看一看 venv . 这个工具提供了独立的Python环境,这比在系统范围内安装包更实用。它还允许在没有管理员权限的情况下安装软件包。这个 contributing tutorial 介绍如何创建虚拟环境。

  3. 创建并激活虚拟环境后,输入命令:

    $ python -m pip install Django
    
    ...\> py -m pip install Django
    

安装特定于分发的包

检查 distribution specific notes 查看您的平台/发行版是否提供了正式的Django包/安装程序。发行版提供的包通常允许自动安装依赖项和支持的升级路径;但是,这些包很少包含Django的最新版本。

安装开发版本

跟踪Django开发

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

如果您想偶尔用最新的错误修复和改进来更新Django代码,请遵循以下说明:

  1. 确保你有 Git 已安装,您可以从shell运行其命令。(进入) git help 在shell提示下进行测试。)

  2. 像这样查看Django的主要开发分支:

    $ git clone https://github.com/django/django.git
    
    ...\> git clone https://github.com/django/django.git
    

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

  3. 确保Python解释器可以加载Django的代码。最方便的方法是使用虚拟环境和 pip. 这个 contributing tutorial 介绍如何创建虚拟环境。

  4. 设置并激活虚拟环境后,运行以下命令:

    $ python -m pip install -e django/
    
    ...\> py -m pip install -e django\
    

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

当您想要更新Django源代码的副本时,运行命令 git pull 从内部 django 目录。当您这样做时,Git将下载任何更改。