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