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

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

Установка Python

Django, являясь фреймворком для веб-приложений на Python, требует установленный Python. Подробности см. в Какой версии Python можно использовать с Django?.

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

Установка 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's 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 из вашей Python site-packages. Чтобы найти каталог, который нужно удалить, вы можете выполнить следующую команду в командной строке (не в интерактивном режиме 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. В руководстве по участию показано, как создать virtualenv в Python 3.

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

   $ pip install -e django/
   

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

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