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

В этом документе вы узнаете, как начать работу с Django.

Установить 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_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, MariaDB, MySQL, Oracle и SQLite.

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

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

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

• Если вы используете PostgreSQL, вам понадобится пакет psycopg2. Дополнительные сведения см. в примечаниях к PostgreSQL.
• Если вы используете MySQL или MariaDB, вам понадобится драйвер 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

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

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

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

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

3. После создания и активации виртуальной среды введите команду:

   $ python -m pip install Django
   

   ...\> py -m pip install Django
   

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

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

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

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

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

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

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

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

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

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

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

   $ python -m pip install -e django/
   

   ...\> py -m pip install -e django\
   

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

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