本文档将帮助您使用Django。
Django is a Python Web framework. See 我应该使用哪个版本的 Python 来配合 Django? for details.
获取最新版本的Python可以通过：访问 https://www.python.org/downloads/ ；或者操作系统的包管理工具。
基于 Jython 的 Django
Jython （一个针对Java平台的Python实现）和Python 3不兼容，所以Django 2.0及以上的版本无法在Jython上运行。
Windows上的Python
如果您刚刚开始学习Django并且使用Windows，查看 如何在Windows上安装Django 可能对你有帮助。
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模块，请查看 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数据库绑定。
cx_Oracle 的支持的版本的详细信息。如果您打算使用Django的 manage.py migrate 命令为您的模型自动创建数据库表（在首次安装Django并创建项目之后），您需要确保Django有权在您正在使用的数据库中创建和更改表；如果你打算手动创建这些表，你可以只需授予Django SELECT，INSERT，UPDATE 和 ``DELETE``权限。创建具有这些权限的数据库用户后，您要在项目的配置文件中指定详细信息，请参阅 DATABASES 以获取详细信息。
如果你正在使用Django的 testing framework 来测试数据库查询，Django将需要创建测试数据库的权限。
Installation instructions are slightly different depending on whether you're installing a distribution-specific package, downloading the latest official release, or fetching the latest development version.
It's easy, no matter which way you choose.
pip¶This is the recommended way to install Django.
pip installed, you might need to update it if
it's outdated. If it's outdated, you'll know because installation won't
work.pip install Django at the shell prompt.Check the distribution specific notes to see if your platform/distribution provides official Django packages/installers. Distribution-provided packages will typically allow for automatic installation of dependencies and easy upgrade paths; however, these packages will rarely contain the latest release of Django.
Tracking Django development
If you decide to use the latest development version of Django, you'll want to pay close attention to the development timeline, and you'll want to keep an eye on the release notes for the upcoming release. This will help you stay on top of any new features you might want to use, as well as any changes you'll need to make to your code when updating your copy of Django. (For stable releases, any necessary changes are documented in the release notes.)
If you'd like to be able to update your Django code occasionally with the latest bug fixes and improvements, follow these instructions:
Make sure that you have Git installed and that you can run its commands
from a shell. (Enter git help at a shell prompt to test this.)
Check out Django's main development branch like so:
$ git clone https://github.com/django/django.git
...\> git clone https://github.com/django/django.git
This will create a directory django in your current directory.
Make sure that the Python interpreter can load Django's code. The most convenient way to do this is to use virtualenv, virtualenvwrapper, and pip. The contributing tutorial walks through how to create a virtualenv.
After setting up and activating the virtualenv, run the following command:
$ pip install -e django/
...\> pip install -e django\
This will make Django's code importable, and will also make the
django-admin utility command available. In other words, you're all
set!
When you want to update your copy of the Django source code, just run the
command git pull from within the django directory. When you do this,
Git will automatically download any changes.
1月 11, 2019