Как установить 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_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, вам понадобится пакет psycopg или psycopg2. Дополнительные сведения см. в примечаниях к PostgreSQL.
• Если вы используете MySQL или MariaDB, вам понадобится драйвер DB API типа mysqlclient. Дополнительные сведения см. в примечаниях к бэкенду MySQL.
• Если вы используете SQLite, вы можете ознакомиться с примечаниями к бэкенду SQLite.
• Если вы используете Oracle, вам потребуется установить oracledb, но, пожалуйста, обратитесь к примечаниям к бэкенду Oracle для получения информации о поддерживаемых версиях Oracle и oracledb.
• Если вы используете неофициальный бэкенд стороннего разработчика, обратитесь к документации для получения дополнительных требований.

Если вы планируете использовать команду 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 загрузит все изменения.