Как установить 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.

Чтобы использовать базу данных, отличную от SQLite, вам нужно убедиться, что установлены соответствующие Python-связки для базы данных:

• Если вы используете PostgreSQL, вам понадобится пакет psycopg или psycopg2. Подробности см. в примечаниях к PostgreSQL.
• Если вы используете MySQL или MariaDB, вам понадобится драйвер DB API вроде mysqlclient. См. примечания к бэкенду MySQL для подробностей.
• Если вы используете SQLite, ознакомьтесь с примечаниями к бэкенду SQLite.
• Если вы используете Oracle, вам нужно установить oracledb, но прочтите примечания к бэкенду Oracle для получения подробностей о поддерживаемых версиях Oracle и oracledb.
• Если вы используете неофициальный сторонний бэкенд, обратитесь к документации, предоставленной для дополнительных требований.

И убедитесь, что следующие ключи в элементе 'default' словаря DATABASES соответствуют настройкам подключения к вашей базе данных:

• ENGINE — это либо 'django.db.backends.sqlite3', 'django.db.backends.postgresql', 'django.db.backends.mysql', или 'django.db.backends.oracle'. Другие бэкенды также доступны.
• NAME — имя вашей базы данных. Если вы используете SQLite, база данных будет файлом на вашем компьютере. В этом случае NAME должно быть полным абсолютным путем, включая имя файла. Вам не нужно ничего создавать предварительно; файл базы данных будет создан автоматически при необходимости. Значение по умолчанию, BASE_DIR / 'db.sqlite3', сохранит файл в каталоге вашего проекта.

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