small_light

'small_light' 指令启用 NGINX 中 ngx_small_light 模块的动态图像转换功能。

语法small_light on | off;
默认值off
上下文http, server, location
参数flag

说明

'small_light' 指令通过启用 ngx_small_light 模块允许在 NGINX 中进行动态图像处理,支持诸如调整大小、旋转和格式转换等操作,适用于 JPEG、PNG 和 WebP 等多种图像格式。当该指令设置为 'on' 时,NGINX 能够处理图像请求并在运行时执行转换,利用底层库例如 ImageMagick。此功能对需要即时图像处理的应用非常有益,减少了存储图像多个版本的需要。

该指令可以在不同上下文中配置,包括 'http'、'server' 和 'location',从而允许对图像转换应用的范围进行细粒度控制。该参数是一个标志(flag),意味着可以简单开启或关闭而无需额外值。默认情况下,处理功能被禁用,将指令设置为 'on' 可激活 ngx_small_light 模块的功能。用户需要确保必要的图像处理库已正确安装和配置,因为操作和性能在很大程度上依赖这些外部库。

配置示例

http {
    server {
        location /images/ {
            small_light on;
        }
    }
}

确保所需的图像处理库(ImageMagick、GD、Imlib2)已正确安装并配置,以实现最佳功能。

注意图像缓存策略,因为对图像进行实时转换可能导致服务器负载增加,从而影响性能。

如果启用了多个图像处理选项,请进行充分测试,以避免库之间的兼容性问题。

← 返回所有指令