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