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