small_light_getparam_mode
small_light_getparam_mode 指令使得可以使用来自 GET 请求的参数来动态转换由 NGINX 提供的图像。
Dynamic image transformation module For NGINX
·
httpserverlocation
语法small_light_getparam_mode on | off;
默认值off
上下文http, server, location
参数flag
说明
small_light_getparam_mode 指令是 NGINX 的动态图像转换模块的一个配置选项，允许服务器在图像转换操作中使用来自 GET 请求的参数。对于需要基于客户端请求进行即时图像处理而无需预定义模式的应用，这尤其有用。启用后，模块可以解析各种查询参数，例如大小、质量或效果，这些参数决定了图像在传送给客户端之前应如何被修改。
就其功能而言，该指令可在 http、server 或 location 上下文中使用，并接受一个标志作为参数。它用于启用或禁用 GET 参数模式；当启用时，模块就可以动态读取并处理这些参数。该指令的底层行为由与保存模块所启用图像处理功能状态的配置结构的关联来控制。通过对客户端特定请求的响应，它显著扩展了服务器端的图像处理能力，确保每个提供的图像都可以在请求时刻根据所需参数进行定制。
正确使用该指令可以提高资源使用效率并提供更个性化的客户端体验，因为图像可以根据实时条件和用户指定的转换进行优化。然而，用户必须确保 GET 参数被明确定义并与模块的处理能力兼容，以避免出现意外行为。
配置示例
server {
listen 80;
server_name example.com;
location /images/ {
small_light_getparam_mode on;
small_light;
}
}⚠
确保对所有必要的查询参数进行适当的验证和清理，以防止潜在的安全问题。
⚠
性能可能会根据 GET 参数的复杂性以及所请求的底层图像处理而有所不同。
⚠
请确保所有引用的图像转换均受已配置的处理库支持。否则，在图像处理过程中会导致错误。