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