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

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

Установите Python

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

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

Python в Windows

Если вы только начинаете работать с Django и используете Windows, вам может пригодиться Как установить Django на Windows.

Установите 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.

Информацию о том, как настроить mod_wsgi после его установки, смотрите в How to use Django with mod_wsgi.

Если по каким-то причинам вы не можете использовать mod_wsgi, не бойтесь: Django поддерживает множество других вариантов развертывания. Один из них - uWSGI; он очень хорошо работает с nginx. Кроме того, Django следует спецификации WSGI (PEP 3333), что позволяет ему работать на различных серверных платформах.

Запустите свою базу данных

Если вы планируете использовать функциональность API базы данных Django, вам необходимо убедиться, что сервер базы данных запущен. Django поддерживает множество различных серверов баз данных и официально поддерживается с PostgreSQL, MariaDB, MySQL, Oracle и SQLite.

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

Помимо официально поддерживаемых баз данных, есть backends provided by 3rd parties, которые позволяют использовать другие базы данных с Django.

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

  • Если вы используете PostgreSQL, то вам потребуется пакет psycopg или psycopg2. Более подробную информацию см. в PostgreSQL notes.
  • Если вы используете MySQL или MariaDB, вам понадобится DB API driver, например mysqlclient. Подробнее см. в разделе notes for the MySQL backend.
  • Если вы используете SQLite, то, возможно, захотите прочитать SQLite backend notes.
  • Если вы используете Oracle, вам потребуется установить oracledb, но, пожалуйста, прочитайте notes for the Oracle backend для получения подробной информации о поддерживаемых версиях Oracle и oracledb.
  • Если вы используете неофициальный бэкенд стороннего производителя, пожалуйста, обратитесь к прилагаемой документации для получения информации о дополнительных требованиях.

Если вы планируете использовать команду Django manage.py migrate для автоматического создания таблиц базы данных для ваших моделей (после первой установки Django и создания проекта), вам необходимо убедиться, что Django имеет права на создание и изменение таблиц в используемой базе данных; если вы планируете создавать таблицы вручную, вы можете предоставить Django права SELECT, INSERT, UPDATE и DELETE. После создания пользователя базы данных с этими разрешениями, вы укажете детали в файле настроек вашего проекта, подробности см. в DATABASES.

Если вы используете Django testing framework для тестирования запросов к базе данных, Django потребуется разрешение на создание тестовой базы данных.

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

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

Установка официального релиза с помощью pip

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

  1. Установите pip. Проще всего использовать standalone pip installer. Если в вашем дистрибутиве уже установлен pip, вам может понадобиться обновить его, если он устарел. Если он устарел, вы узнаете об этом, потому что установка не будет работать.

  2. Посмотрите на venv. Этот инструмент обеспечивает изолированное окружение Python, что более практично, чем установка пакетов по всей системе. Он также позволяет устанавливать пакеты без привилегий администратора. В contributing tutorial рассказывается о том, как создать виртуальную среду.

  3. После того как вы создали и активировали виртуальную среду, введите команду:

    $ python -m pip install Django
    
    ...\> py -m pip install Django
    

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

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

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

Отслеживание разработки Django

Если вы решите использовать последнюю версию Django для разработки, вам стоит обратить пристальное внимание на the development timeline, а также следить за release notes for the upcoming release. Это поможет вам быть в курсе всех новых возможностей, которые вы захотите использовать, а также всех изменений, которые вам нужно будет внести в ваш код при обновлении вашей копии 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. В contributing tutorial рассказывается о том, как создать виртуальное окружение.

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

    $ python -m pip install -e django/
    
    ...\> py -m pip install -e django\
    

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

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

Вернуться на верх