small_light_radius_max

指令 `small_light_radius_max` 在 NGINX 的 small_light 模块中设置图像处理允许的最大半径。

语法small_light_radius_max number;
默认值none
上下文http, server, location
参数1

说明

small_light_radius_max 指令与 NGINX 的 small_light 模块提供的图像变换过程配合使用。该指令定义了在处理图像(例如模糊或锐化等效果)时可以应用的最大半径。通过设置最大值,它有助于维护性能和资源管理,防止过大的变换导致高内存使用或响应变慢。

该指令接受一个参数,单位为像素。它可在包括 http、server 和 location 块在内的多个上下文中使用,允许在 NGINX 配置的不同层级进行灵活配置。small_light 模块本身支持动态图像处理功能,该指令在微调这些变换如何执行方面起着关键作用,尤其是在保持图像质量的同时管理计算开销。

需要注意的是,为该指令设置合适的值对于在图像处理质量与性能限制之间取得平衡至关重要。管理员应在不同半径设置下测试图像处理,以找到既满足质量要求又不会压垮服务器资源的最佳配置。

配置示例

http {
    small_light_radius_max 50;
    server {
        location /images/ {
            small_light;
        }
    }
}

过高的值可能导致内存使用增加,并可能使响应时间变慢。

确保该模块在 NGINX 中已正确编译并启用;否则,该指令将不起作用。

该值必须为正整数;任何无效或负值将在配置加载期间导致错误。

← 返回所有指令