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

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

Установка Python

Как веб-фреймворк на Python, Django требует 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 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 sys; sys.path = sys.path[1:]; 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 автоматически загрузит любые изменения.