Как установить Django

Этот документ поможет вам начать работу с Django.

Установка Python

В качестве веб-фреймворка на Python, Django требует Python. Подробнее см. Какие версии Python поддерживаются Django?.

Получите последнюю версию Python по адресу https://www.python.org/downloads/ или с помощью менеджера пакетов вашей операционной системы.

Установка Apache и mod_wsgi

Если вы хотите просто поэкспериментировать с Django, перейдите к следующему разделу. Django включает в себя лёгкий веб-сервер, который можно использовать для тестирования, поэтому вам не нужно настраивать Apache, пока вы не готовы развернуть Django в рабочей среде.

Если вы хотите использовать Django на рабочем сайте, используйте Apache с mod_wsgi. mod_wsgi может работать в двух режимах: встроенном и демоновом. Встроенном режиме mod_wsgi похож на mod_perl — он встраивает Python в Apache и загружает код Python в память при запуске сервера. Код остаётся в памяти на протяжении всего жизненного цикла процесса Apache, что приводит к существенному увеличению производительности по сравнению с другими конфигурациями сервера. В демоновом режиме mod_wsgi запускает отдельный демоновый процесс, который обрабатывает запросы. Демонный процесс может выполняться от имени другого пользователя, что может привести к улучшению безопасности, и демонный процесс может перезапускаться без перезапуска всего веб-сервера Apache, что может сделать обновление вашего кода более бесшовным. Обратитесь к документации mod_wsgi, чтобы определить, какой режим подходит для вашей настройки. Убедитесь, что у вас установлен Apache с активированным модулем mod_wsgi. Django будет работать с любой версией Apache, которая поддерживает mod_wsgi.

См. Как использовать Django с mod_wsgi для получения информации о конфигурации mod_wsgi после его установки.

Если по какой-то причине вы не можете использовать mod_wsgi, не отчаивайтесь: Django поддерживает множество других вариантов развертывания. Одним из них является uWSGI; он отлично работает с nginx. Кроме того, Django соответствует спецификации WSGI (PEP 3333), что позволяет ему работать на различных платформах серверов.

Настройка базы данных

Если вы планируете использовать функциональность API базы данных Django, вам необходимо убедиться, что сервер базы данных запущен. Django поддерживает множество различных серверов баз данных и официально поддерживается PostgreSQL, MySQL, Oracle и SQLite.

Если вы разрабатываете небольшой проект или что-то, что вы не планируете развертывать в рабочей среде, SQLite, как правило, является самым простым вариантом, так как он не требует запуска отдельного сервера. Однако у SQLite есть много отличий от других баз данных, поэтому если вы работаете над чем-то значительным, рекомендуется разрабатывать с той же базой данных, которую вы планируете использовать в рабочей среде.

Помимо официально поддерживаемых баз данных, существуют бекенды, предоставляемые третьими сторонами, которые позволяют вам использовать другие базы данных с Django.

Помимо бэкенда базы данных, вам необходимо убедиться, что установлены ваши Python-связующие для базы данных.

• Если вы используете PostgreSQL, вам потребуется пакет psycopg2. Дополнительные сведения см. в примечаниях к PostgreSQL.
• Если вы используете MySQL, вам потребуется драйвер DB API, например, mysqlclient. Дополнительные сведения см. в примечаниях к бэкенду MySQL.
• Если вы используете SQLite, вы можете ознакомиться с примечаниями к бэкенду SQLite.
• Если вы используете Oracle, вам потребуется копия cx_Oracle, но, пожалуйста, прочитайте примечания к бэкенду Oracle для получения сведений о поддерживаемых версиях Oracle и cx_Oracle.
• Если вы используете неофициальный бэкенд третьей стороны, пожалуйста, ознакомьтесь с документацией, предоставленной для любых дополнительных требований.

Если вы планируете использовать команду Django manage.py migrate для автоматической генерации таблиц базы данных для ваших моделей (после первоначальной установки Django и создания проекта), вам необходимо убедиться, что у Django есть разрешения на создание и изменение таблиц в используемой вами базе данных; если вы планируете создавать таблицы вручную, вы можете просто предоставить Django права SELECT, INSERT, UPDATE и DELETE. После создания пользователя базы данных с этими разрешениями, вы укажете данные в файле настроек проекта. См. DATABASES для получения дополнительной информации.

Если вы используете фреймворк тестирования Django для тестирования базы данных, Django потребуются разрешения для создания тестовой базы данных.

Удаление старых версий Django

Если вы обновляете Django с предыдущей версии, вам необходимо удалить старую версию Django перед установкой новой.

Если вы устанавливали Django с помощью pip или easy_install ранее, установка с pip или easy_install вновь автоматически позаботится о старой версии, поэтому вам не нужно делать это самостоятельно.

Если вы ранее устанавливали Django с помощью python setup.py install, удаление так же просто, как удаление каталога django из вашей site-packages Python.

Для того, чтобы найти каталог, который нужно удалить, вы можете выполнить следующую команду в вашей командной строке (не в интерактивной Python-консоли):

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

Установка кода Django

Инструкции по установке немного отличаются в зависимости от того, устанавливаете ли вы пакет, специфичный для дистрибутива, скачиваете последнюю официальную версию или получаете последнюю версию разработки.

Это легко, независимо от выбранного способа.

Установка официальной версии с pip

Это рекомендуемый способ установки Django.

1. Установите pip. Самый простой способ — использовать установщик pip. Если ваш дистрибутив уже имеет pip , вам может потребоваться обновить его, если он устарел. Если он устарел, вы об этом узнаете, так как установка не будет работать.
2. Обратите внимание на virtualenv и virtualenvwrapper. Эти инструменты предоставляют изолированные среды Python, которые более практичны, чем установка пакетов по всей системе. Они также позволяют устанавливать пакеты без прав администратора. В обучающем пособии по сотрудничеству показано, как создать virtualenv на Python 3.
3. После создания и активации виртуальной среды введите команду pip install Django в командной строке.

Установка пакета для конкретного дистрибутива

См. замечания по дистрибутиву для получения сведений о том, предоставляет ли ваша платформа/дистрибутив официальные пакеты/инсталляторы Django. Пакеты, предоставляемые дистрибутивом, обычно позволяют автоматически устанавливать зависимости и обеспечивают простые пути обновления; однако эти пакеты редко содержат последнюю версию Django.

Установка версии разработки

Если вы хотите периодически обновлять свой код Django до последних исправлений ошибок и улучшений, следуйте этим инструкциям:

1. Убедитесь, что у вас установлен Git и что вы можете выполнить его команды из командной строки. (Введите git help в командной строке для проверки.)

2. Выполните операцию проверки основной ветви разработки Django следующим образом:

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

   Это создаст каталог django в текущем каталоге.

3. Убедитесь, что интерпретатор Python может загрузить код Django. Наиболее удобным способом сделать это является использование virtualenv, virtualenvwrapper и pip. В учебнике по участию описан процесс создания виртуальной среды для Python 3.

4. После настройки и активации виртуальной среды выполните следующую команду:

   $ pip install -e django/
   

   Это сделает код Django загружаемым и сделает доступной утилиту django-admin . Другими словами, всё готово!

При необходимости обновить вашу копию исходного кода Django, просто выполните команду git pull в каталоге django. В этом случае Git автоматически загрузит все изменения.