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

Если вы разрабатываете простой проект или проект, который не планируете развертывать в рабочей среде, SQLite, как правило, является самым простым вариантом, так как он не требует запуска отдельного сервера. Однако SQLite имеет множество отличий от других баз данных, поэтому, если вы работаете над чем-то значительным, рекомендуется использовать ту же базу данных, что и в рабочей среде.

В дополнение к официально поддерживаемым базам данных существуют бекенды, предоставляемые сторонними разработчиками, которые позволяют использовать другие базы данных с Django.

В дополнение к бэкенду базы данных вам нужно убедиться, что установлены ваши Python-связки для базы данных.

• Если вы используете PostgreSQL, вам понадобится пакет psycopg2. Дополнительные сведения см. в Примечания к PostgreSQL.
• Если вы используете MySQL, вам понадобится драйвер 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. Посмотрите на virtualenv и virtualenvwrapper. Эти инструменты обеспечивают изолированные среды Python, которые более практичны, чем установка пакетов на весь компьютер. Они также позволяют устанавливать пакеты без привилегий администратора. В руководстве по участию есть инструкция по созданию virtualenv.

3. После создания и активации виртуальной среды введите команду:

   $ pip install Django
   

   ...\> pip install Django
   

Установка пакета, специфичного для дистрибутива

Проверьте заметки по дистрибутивам, чтобы узнать, предоставляет ли ваша платформа/дистрибутив официальные пакеты/инсталляторы Django. Пакеты, предоставляемые дистрибутивом, обычно позволяют автоматически устанавливать зависимости и упрощают процесс обновления; однако эти пакеты редко содержат последнюю версию Django.

Установка версии разработки

Если вы хотите периодически обновлять свой код Django до последних исправлений ошибок и улучшений, выполните следующие действия:

1. Убедитесь, что у вас установлен Git и вы можете выполнять его команды из командной строки. (Введите git help в командной строке, чтобы проверить это.)

2. Выполните checkout основной ветки разработки Django:

   $ git clone https://github.com/django/django.git
   

   ...\> git clone https://github.com/django/django.git
   

   Это создаст каталог django в текущем каталоге.

3. Убедитесь, что интерпретатор Python может загрузить код Django. Наиболее удобный способ сделать это — использовать virtualenv, virtualenvwrapper и pip. В руководстве по участию есть инструкция по созданию virtualenv.

4. После настройки и активации virtualenv выполните следующую команду:

   $ pip install -e django/
   

   ...\> pip install -e django\
   

   Это сделает код Django загружаемым и также сделает доступной утилиту django-admin. Другими словами, всё готово!

При обновлении вашей копии исходного кода Django, просто выполните команду git pull в каталоге django. В этом случае Git автоматически загрузит все изменения.