Как установить 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 после его установки см. в руководстве Как использовать Django с mod_wsgi.
Если по какой-либо причине вы не можете использовать mod_wsgi, не беспокойтесь: Django поддерживает множество других способов развёртывания. Один из них — uWSGI; он отлично работает с nginx. Кроме того, Django соответствует спецификации WSGI (PEP 3333), благодаря чему может работать на различных серверных платформах.
Настройка базы данных
Если вы планируете использовать API Django для работы с базой данных, убедитесь, что сервер базы данных запущен. Django поддерживает множество серверов баз данных и официально совместим с PostgreSQL, MariaDB, MySQL, Oracle и SQLite.
Если вы разрабатываете небольшой проект или проект, который не планируете развёртывать в рабочей среде, обычно лучше всего выбрать SQLite, поскольку для неё не требуется запускать отдельный сервер. Однако SQLite во многом отличается от других баз данных, поэтому, если вы работаете над чем-то существенным, рекомендуется вести разработку с той же базой данных, которую планируете использовать в рабочей среде.
Помимо официально поддерживаемых баз данных, существуют бэкенды, предоставляемые сторонними разработчиками, позволяющие использовать с Django другие базы данных.
Чтобы использовать базу данных, отличную от SQLite, убедитесь, что установлены соответствующие привязки Python для работы с базой данных:
- Если вы используете PostgreSQL, вам понадобится пакет psycopg или psycopg2. Дополнительную информацию см. в примечаниях о PostgreSQL.
- Если вы используете MySQL или MariaDB, вам понадобится драйвер DB API, например
mysqlclient. Подробности см. в примечаниях о бэкенде MySQL. - Если вы используете SQLite, возможно, вам пригодятся примечания о бэкенде SQLite.
- Если вы используете Oracle, вам понадобится установить oracledb. Подробности о поддерживаемых версиях Oracle и
oracledbсм. в примечаниях о бэкенде Oracle. - Если вы используете неофициальный бэкенд стороннего разработчика, ознакомьтесь с предоставленной документацией, чтобы узнать о дополнительных требованиях.
Также убедитесь, что следующие ключи в элементе 'default' словаря DATABASES соответствуют настройкам подключения к вашей базе данных:
-
ENGINE— одно из значений'django.db.backends.sqlite3','django.db.backends.postgresql','django.db.backends.mysql'или'django.db.backends.oracle'. Доступны и другие бэкенды. -
NAME— имя вашей базы данных. При использовании SQLite база данных будет представлена файлом на вашем компьютере. В этом случаеNAMEдолжен содержать полный абсолютный путь, включая имя файла. Создавать файл заранее не нужно: он будет создан автоматически при необходимости. Значение по умолчанию,BASE_DIR / 'db.sqlite3', указывает сохранять файл в каталоге проекта.
Для баз данных, отличных от SQLite
Если вы используете не SQLite, необходимо добавить дополнительные настройки, такие как USER, PASSWORD и HOST. Подробности см. в справочной документации по параметру DATABASES.
Также к этому моменту убедитесь, что база данных создана. Для этого выполните команду «CREATE DATABASE database_name;» в интерактивной оболочке вашей базы данных.
Если вы планируете использовать команду manage.py migrate Django для автоматического создания таблиц базы данных для ваших моделей (после установки Django и создания проекта), убедитесь, что у Django есть разрешение на создание и изменение таблиц в используемой базе данных; если вы планируете создавать таблицы вручную, можно предоставить Django разрешения SELECT, INSERT, UPDATE и DELETE. Создав пользователя базы данных с этими разрешениями, укажите соответствующие параметры в файле настроек проекта. Подробности см. в разделе DATABASES.
Если вы используете среду тестирования Django для проверки запросов к базе данных, Django потребуется разрешение на создание тестовой базы данных.
Установка кода Django
Инструкции по установке немного различаются в зависимости от того, устанавливаете ли вы пакет для конкретного дистрибутива, скачиваете последнюю официальную версию или получаете последнюю версию для разработки.
Установка официальной версии с помощью pip
Это рекомендуемый способ установки Django.
- Установите pip. Проще всего воспользоваться автономным установщиком pip. Если в вашем дистрибутиве уже установлен
pip, возможно, потребуется обновить его, если он устарел. Вы поймёте, что он устарел, если установка не сработает. - Ознакомьтесь с инструментом venv. Он создаёт изолированные среды Python, которые практичнее установки пакетов для всей системы. Кроме того, он позволяет устанавливать пакеты без прав администратора. В руководстве по участию в разработке описано создание виртуальной среды.
-
Создав и активировав виртуальную среду, выполните команду:
$ python -m pip install Django
...\> py -m pip install Django
Установка пакета для конкретного дистрибутива
Ознакомьтесь с примечаниями для конкретных дистрибутивов, чтобы узнать, предоставляет ли ваша платформа или дистрибутив официальные пакеты или установщики Django. Пакеты, предоставляемые дистрибутивами, обычно позволяют автоматически устанавливать зависимости и поддерживают удобные пути обновления; однако в таких пакетах редко содержится последняя версия Django.
Установка версии для разработки
Отслеживание разработки Django
Если вы решили использовать последнюю версию Django для разработки, внимательно следите за ходом разработки и примечаниями к предстоящему выпуску. Это поможет вам быть в курсе новых функций, которые вы можете захотеть использовать, а также изменений, которые потребуется внести в ваш код при обновлении копии Django. (Для стабильных выпусков все необходимые изменения описаны в примечаниях к выпуску.)
Если вы хотите время от времени обновлять код Django, получая последние исправления ошибок и улучшения, следуйте этим инструкциям:
- Убедитесь, что у вас установлен Git и вы можете запускать его команды из командной оболочки. (Чтобы проверить это, введите
git helpв командной строке.) -
Получите основную ветку разработки Django, выполнив следующие действия:
$ git clone https://github.com/django/django.git
...\> git clone https://github.com/django/django.gitВ текущем каталоге будет создан каталог
django. - Убедитесь, что интерпретатор Python может загружать код Django. Удобнее всего сделать это с помощью виртуальной среды и pip. В руководстве по участию в разработке описано создание виртуальной среды.
-
Настроив и активировав виртуальную среду, выполните следующую команду:
$ python -m pip install -e django/
...\> py -m pip install -e django\Это позволит импортировать код Django, а также сделает доступной служебную команду
django-admin. Другими словами, всё готово!
Чтобы обновить копию исходного кода Django, выполните команду git pull из каталога django. Git загрузит все изменения.
© Django Software Foundation and individual contributors
Licensed under the BSD License.
https://docs.djangoproject.com/en/6.0/topics/install/
