Как установить Django

Этот документ поможет вам начать работу с Django.

Установка Python

Как веб-фреймворк на Python, Django требует Python. Подробности см. в Какой версии Python можно использовать с Django?.

Получите последнюю версию Python по адресу https://www.python.org/download/ или с помощью менеджера пакетов вашей операционной системы.

Установка 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, вам понадобится драйвер 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

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

Если вы устанавливали Django с помощью pip или easy_install ранее, установка с помощью pip или easy_install снова автоматически позаботится о старой версии, поэтому вам не нужно делать это самостоятельно.

Если вы ранее устанавливали Django с помощью python setup.py install, удаление так же просто, как удаление каталога django из вашей Python-среды site-packages. Чтобы найти каталог, который нужно удалить, вы можете выполнить следующую команду в командной строке (не в интерактивной оболочке Python):

$ python -c "import django; print(django.__path__)"

Установка кода Django

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

Это легко сделать, независимо от выбранного вами способа.

Установка официальной версии с pip

Это рекомендуемый способ установки Django.

1. Установите pip. Самый простой способ — использовать автономный установщик pip. Если у вашего дистрибутива уже установлен pip, возможно, вам потребуется обновить его, если он устарел. Если он устарел, вы об этом узнаете, так как установка не будет работать.
2. Обратите внимание на virtualenv и virtualenvwrapper. Эти инструменты обеспечивают изолированные среды Python, которые более практичны, чем установка пакетов на весь компьютер. Они также позволяют устанавливать пакеты без прав администратора. Учебник по участию описывает, как создать virtualenv в Python 3.
3. После создания и активации виртуальной среды введите команду pip install Django в командной строке.

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

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

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

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

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

2. Проверьте главную ветвь разработки Django следующим образом:

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

   Это создаст директорию django в вашей текущей директории.

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

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

   $ pip install -e django/
   

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

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