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

Этот документ призван проинструктировать вас о том, как получить и запустить Django.

Установка Python

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

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

Python на Windows

Если вы только начали изучать Django и используете Windows, советуем почитать How to install Django on Windows.

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

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

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.

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

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

Создание рабочей базы данных

If you plan to use Django’s database API functionality, you’ll need to make sure a database server is running. Django supports many different database servers and is officially supported with PostgreSQL, MariaDB, MySQL, Oracle and SQLite.

If you are developing a small project or something you don’t plan to deploy in a production environment, SQLite is generally the best option as it doesn’t require running a separate server. However, SQLite has many differences from other databases, so if you are working on something substantial, it’s recommended to develop with the same database that you plan on using in production.

В дополнение к официально поддерживаемым базам данных есть бэкэнды, поставляемые третьими сторонами, которые позволяют использовать другие БД с Django.

В дополнение к установке необходимой БД вы также должны убедиться, что вами выбран и установлен соответствующий модуль Python.

  • При использовании PostgreSQL вам понадобится пакет psycopg2. Вы можете обратиться к заметкам о PostgreSQL для получения дальнейших инструкций, специфичных для этой БД.
  • If you’re using MySQL or MariaDB, you’ll need a DB API driver like mysqlclient. See notes for the MySQL backend for details.
  • Если вы используете SQLite, вам следует прочитать про особенности использования SQLite.
  • При использовании Oracle вам понадобится копия cx_Oracle, но, пожалуйста, обязательно ознакомьтесь с заметками для Oracle , которая содержит информацию о поддерживаемых версиях Oracle и cx_Oracle.
  • При использовании неофициальных бэкендов от сторонних разработчиков смотрите соответствующую документацию о дополнительных требованиях.

If you plan to use Django’s manage.py migrate command to automatically create database tables for your models (after first installing Django and creating a project), you’ll need to ensure that Django has permission to create and alter tables in the database you’re using; if you plan to manually create the tables, you can grant Django SELECT, INSERT, UPDATE and DELETE permissions. After creating a database user with these permissions, you’ll specify the details in your project’s settings file, see DATABASES for details.

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

Установка Django

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

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

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

  1. Установите pip. Самым простым способом сделать это является использование автономного установщика pip. Если ваш дистрибутив уже включает установленную версию pip, возможно, вам потребуется обновить её до более свежей. (Если версия устарела, вы сразу поймёте это, поскольку установка не будет работать.)

  2. Взгляните на virtualenv и virtualenvwrapper. Эти программы предоставляют изолированное окружение Python, что намного более практично, чем установка общесистемных пакетов. Такой подход также позволяет провести установку без административных прав. Раздел о разработке Django описывает как создать виртуальное окружение

  3. After you’ve created and activated a virtual environment, enter the command:

    $ python -m pip install Django

    ...\> py -m pip install Django

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

Check the distribution specific notes to see if your platform/distribution provides official Django packages/installers. Distribution-provided packages will typically allow for automatic installation of dependencies and supported upgrade paths; however, these packages will rarely contain the latest release of Django.

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

Следим за разработкой Django

Если вы приняли решение использовать текущую разрабатываемую версию Django, вам нужно следить за информацией о выпуске новых исправлений на the development timeline. Это поможет вам оставаться в курсе происходящих изменений , таких как включение новой функциональности. Для получения изменений вы должны будете обновить вашу копию 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. Самый удобный способ сделать это – использовать virtualenv, virtualenvwrapper и pip. Раздел о разработке Django описывает как создать виртуальное окружение.

  4. После того, как вы создали и активировали виртуальное окружение, выполните в консоли:

    $ python -m pip install -e django/

    ...\> py -m pip install -e django\

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

When you want to update your copy of the Django source code, run the command git pull from within the django directory. When you do this, Git will download any changes.

« previous | up | next »