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 之前确认该目录存在,因为 NGINX 不会自动创建该目录。

必须监控临时空间,以防因文件累积而耗尽磁盘空间。

← 返回所有指令