small_light_material_dir

Директива `small_light_material_dir` определяет каталог для хранения временных преобразований изображений.

Синтаксисsmall_light_material_dir path;
По умолчаниюnone
Контекстserver
Аргументы1

Описание

Эта директива является частью Dynamic Image Transformation Module for NGINX, позволяя серверу выполнять преобразования изображений «на лету». Когда изображения преобразуются, полученные временные файлы должны быть сохранены в указанном месте до выдачи клиентам. Указывая small_light_material_dir, пользователь может контролировать, где сохраняются эти временные файлы, что обеспечивает лучшую организацию или соответствие политикам хранения. Аргумент, передаваемый этой директиве, должен быть путем к требуемому каталогу, и крайне важно, чтобы этот каталог имел корректные права доступа, чтобы сервер NGINX мог записывать в него.

В работе, когда изображение запрашивается с параметрами преобразования, модуль будет проверять этот каталог на наличие уже обработанных изображений. Если запрошено необработанное изображение, он выполнит необходимые преобразования и сохранит результат в указанном small_light_material_dir. Такое поведение оптимизирует время ответа для повторных запросов на то же самое преобразование, поскольку последующие запросы могут сразу вернуть закешированную версию вместо повторной обработки исходного файла. Директива должна находиться в контексте server, и она ожидает один аргумент, указывающий путь к каталогу.

Пример конфига

server {
    listen 80;
    server_name example.com;

    small_light_material_dir /var/tmp/small_light;
}
⚠

Убедитесь, что указанная директория имеет достаточные права записи для пользователя NGINX.

⚠

Проверьте, что директория существует перед запуском NGINX, так как он не создаёт её автоматически.

⚠

Необходимо контролировать доступное временное пространство, чтобы предотвратить исчерпание места на диске из-за накопившихся файлов.

← Ко всем директивам