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

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

Установите Python

Django is a Python web framework. See Какие версии Python можно использовать с Django? for details.

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

Python в Windows

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

Установите Apache и mod_wsgi

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

If you want to use Django on a production site, use Apache with mod_wsgi. mod_wsgi operates in one of two modes: embedded mode or daemon mode. In embedded mode, mod_wsgi is similar to mod_perl – it embeds Python within Apache and loads Python code into memory when the server starts. Code stays in memory throughout the life of an Apache process, which leads to significant performance gains over other server arrangements. In daemon mode, mod_wsgi spawns an independent daemon process that handles requests. The daemon process can run as a different user than the web server, possibly leading to improved security. The daemon process can be restarted without restarting the entire Apache web server, possibly making refreshing your codebase more seamless. Consult the mod_wsgi documentation to determine which mode is right for your setup. Make sure you have Apache installed with the mod_wsgi module activated. Django will work with any version of Apache that supports 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 установлена.

  • If you’re using PostgreSQL, you’ll need the psycopg or psycopg2 package. Refer to the PostgreSQL notes for further details.
  • Если вы используете MySQL или MariaDB, вам понадобится DB API driver, как mysqlclient. Подробнее смотрите notes for the MySQL backend.
  • Если вы используете SQLite, то, возможно, захотите прочитать SQLite backend notes.
  • Если вы используете Oracle, вам понадобится копия cx_Oracle, но, пожалуйста, прочитайте notes for the Oracle backend для получения подробной информации о поддерживаемых версиях как Oracle, так и cx_Oracle.
  • Если вы используете неофициальный бэкенд стороннего производителя, пожалуйста, обратитесь к прилагаемой документации для получения информации о дополнительных требованиях.

Если вы планируете использовать команду 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 загрузит все изменения.

Использование Django
Модели и базы данных
Вернуться на верх