Управление статическими файлами (например, изображениями, JavaScript, CSS)

Веб-сайты обычно нуждаются в предоставлении дополнительных файлов, таких как изображения, JavaScript или CSS. В Django эти файлы называются «статическими файлами». Django предоставляет django.contrib.staticfiles, чтобы помочь вам в их управлении.

Эта страница описывает, как вы можете предоставить эти статические файлы.

Настройка статических файлов

1. Убедитесь, что django.contrib.staticfiles включен в ваш INSTALLED_APPS.

2. В вашем файле настроек определите STATIC_URL, например:

   STATIC_URL = '/static/'
   

3. В ваших шаблонах либо жестко закодируйте URL, как /static/my_app/example.jpg, или, предпочтительно, используйте static тег шаблона для построения URL для данного относительного пути, используя настроенное хранилище STATICFILES_STORAGE (это значительно упрощает переход на сеть доставки контента (CDN) для предоставления статических файлов).

   {% load static %}
   <img src="{% static "my_app/example.jpg" %}" alt="My image"/>
   

4. Храните ваши статические файлы в папке, называемой static в вашем приложении. Например, my_app/static/my_app/example.jpg.

В вашем проекте, вероятно, также будут статические ресурсы, которые не связаны с конкретным приложением. В дополнение к использованию директории static/ внутри ваших приложений, вы можете определить список директорий (STATICFILES_DIRS) в вашем файле настроек, где Django также будет искать статические файлы. Например:

STATICFILES_DIRS = [
    os.path.join(BASE_DIR, "static"),
    '/var/www/static/',
]

См. документацию для настройки STATICFILES_FINDERS для получения подробной информации о том, как staticfiles находит ваши файлы.

Предоставление статических файлов во время разработки

Если вы используете django.contrib.staticfiles, как описано выше, runserver сделает это автоматически, когда DEBUG установлено в True. Если у вас нет django.contrib.staticfiles в INSTALLED_APPS, вы всё ещё можете вручную предоставить статические файлы, используя представление django.contrib.staticfiles.views.serve().

Это не подходит для использования в производстве! Для некоторых распространённых стратегий развертывания см. Развёртывание статических файлов.

Например, если ваш STATIC_URL определён как /static/, вы можете сделать это, добавив следующий фрагмент в ваш файл urls.py:

from django.conf import settings
from django.conf.urls.static import static

urlpatterns = [
    # ... the rest of your URLconf goes here ...
] + static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)

Предоставление файлов, загруженных пользователем, во время разработки

Во время разработки вы можете предоставить загруженные пользователем медиафайлы из MEDIA_ROOT, используя представление django.contrib.staticfiles.views.serve().

Это не подходит для использования в производстве! Для некоторых распространённых стратегий развертывания см. Развёртывание статических файлов.

Например, если ваш MEDIA_URL определён как /media/, вы можете сделать это, добавив следующий фрагмент в ваш файл urls.py:

from django.conf import settings
from django.conf.urls.static import static

urlpatterns = [
    # ... the rest of your URLconf goes here ...
] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

Тестирование

При запуске тестов, которые используют реальные HTTP-запросы вместо встроенного клиентского теста (т. е. при использовании встроенного LiveServerTestCase) статические ресурсы должны предоставляться вместе с остальным содержимым, чтобы тестовая среда как можно точнее воспроизводила реальную, но LiveServerTestCase имеет только очень базовые возможности предоставления статических файлов: Она не знает о функции поиска приложения staticfiles и предполагает, что статический контент уже собран в STATIC_ROOT.

Из-за этого staticfiles поставляет свой собственный django.contrib.staticfiles.testing.StaticLiveServerTestCase, подкласс встроенного, который имеет возможность прозрачно предоставлять все ресурсы во время выполнения этих тестов аналогично тому, что мы получаем во время разработки с DEBUG = True, т. е. без необходимости собирать их с помощью collectstatic предварительно.

Развертывание

django.contrib.staticfiles предоставляет удобную команду управления для сбора статических файлов в одну директорию, чтобы вы могли легко их предоставить.

1. Установите настройку STATIC_ROOT на директорию, из которой вы хотите предоставить эти файлы, например:

   STATIC_ROOT = "/var/www/example.com/static/"
   

2. Запустите команду управления collectstatic:

   $ python manage.py collectstatic
   

   Это скопирует все файлы из ваших статических папок в директорию STATIC_ROOT.

3. Используйте веб-сервер по вашему выбору для предоставления файлов. Развертывание статических файлов описывает некоторые распространённые стратегии развертывания статических файлов.

Дополнительная информация

Этот документ охватывает основы и некоторые распространённые шаблоны использования. Для получения полной информации обо всех настройках, командах, тегах шаблонов и других элементах, включённых в django.contrib.staticfiles, см. справочник по staticfiles.