`ngx_http_compress_normalize_module`` is an Nginx module designed to parse, normalize, and manage the Accept-Encoding headers from client requests. It ensures consistent handling of compression algorithms by standardizing the Accept-Encoding values, facilitating better compression management and improved vary cache performance.
This Nginx module is currently considered experimental. Issues and PRs are welcome if you encounter any problems.
http {
compress_normalize_accept_encoding gzip,br,zstd gzip,br zstd br gzip;
server {
listen 80;
server_name example.com;
location / {
# Your configurations
}
}
}To use theses modules, configure your nginx branch with --add-module=/path/to/ngx_http_compress_normalize_module.
Syntax: compress_normalize_accept_encoding combinations1 [combinations2 ..] | off;
Default: compress_normalize_accept_encoding off;
Context: http, server, location
Enables the normalization of the Accept-Encoding header by specifying preferred combinations of compression algorithms. This directive accepts a list of compression methods, allowing to define the order and priority of encoding types that the server should prefer when responding to client requests.
For example, with the following configuration
compress_normalize_accept_encoding gzip,br,zstd gzip,br zstd br gzip;If the request header Accept-Encoding contains gzip, br and zstd at the same time, the value of the standardized Accept-Encoding header is gzip,br,zstd. If the above conditions are not met, but the request header contains gzip and br, the value of the standardized Accept-Encoding header is gzip,br. And so on, until all the combinations given by the compress_normalize_accept_encoding directive are checked. If no combination is hit at this time, the Accept-Encoding header is directly deleted.
A value of off will disable this feature.
keeps the original value of request Accept-Encoding header.
Hanada [email protected]
This Nginx module is licensed under BSD 2-Clause License.