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