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

Если вы обновляете свою установку 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.
3. После создания и активации виртуальной среды введите команду pip install Django в командной строке.

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

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

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

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

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

2. Выполните отложенную проверку основной ветки разработки Django следующим образом:

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

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

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

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

   $ pip install -e django/
   

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

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