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