From be1c7e50e1e8809ea56f2c9d472eccd8ffd73a97 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Fri, 19 Apr 2024 04:57:58 +0200 Subject: Adding upstream version 1.44.3. Signed-off-by: Daniel Baumann --- .../libh2o/doc/configure/compress_directives.html | 177 +++++++++++++++++++++ 1 file changed, 177 insertions(+) create mode 100644 web/server/h2o/libh2o/doc/configure/compress_directives.html (limited to 'web/server/h2o/libh2o/doc/configure/compress_directives.html') diff --git a/web/server/h2o/libh2o/doc/configure/compress_directives.html b/web/server/h2o/libh2o/doc/configure/compress_directives.html new file mode 100644 index 00000000..04336e11 --- /dev/null +++ b/web/server/h2o/libh2o/doc/configure/compress_directives.html @@ -0,0 +1,177 @@ + + + + + + + + + + + + + + + + +Compress Directives - Configure - H2O - the optimized HTTP/2 server + + +
+
+ +

+H2O +

+

the optimized HTTP/1.x, HTTP/2 server

+ + +
+ +
+ +
+
+
+Powered by Oktavia +
+
+ + +
+ + + + + + + + + + + + +
+ +

+Configure > +Compress Directives +

+ + +

+The compress handler performs on-the-fly compression - it compresses the contents of an HTTP response as it is being sent, if the client indicates itself to be capable of decompressing the response transparently with the use of Accept-Encoding header, and if the response is deemed compressible according to the following rules. +

+

+If x-compress-hint response header does not exist or the value is auto, then whether if the response is considered compressible depends on the is_compressible attribute assigned to the content type (see file.mime.addtypes). +If x-compress-hint response header exists and the value is on, the response is always considered to be compressible. +If the value of the response header is set to off, then the response never gets compressed. +

+ +

+The following are the configuration directives recognized by the handler. +

+ +
+
since v2.0
+

"compress"

+
+ +
+
Description:
+
+

+Enables on-the-fly compression of HTTP response. + +

+ +

+If the argument is ON, both brotli and gzip compression are enabled. +If the argument is OFF, on-the-fly compression is disabled. +If the argument is a sequence, the elements are the list of compression algorithms to be enabled. +If the argument is a mapping, each key specifies the compression algorithm to be enabled, and the values specify the quality of the algorithms. +

+

+When both brotli and gzip are enabled and if the client supports both, H2O is hard-coded to prefer brotli. +

+
+
Example. Enabling on-the-fly compression
+
# enable all algorithms
+compress: ON
+
+# enable by name
+compress: [ gzip, br ]
+
+# enable gzip only
+compress: [ gzip ]
+
+
+ + +
+
Level:
+
global, host, path, extension
+
Default:
+
compress: OFF
 +
See also:
+
file.send-compressed, file.mime.addtypes +
+
+ +
+
since v2.0
+

"compress-minimum-size"

+
+ +
+
Description:
+
+

+Defines the minimum size a files needs to have in order for H2O to compress the request. + +

+ +
+
Level:
+
global, host, path, extension
+
Default:
+
compress-minimum-size: 100
 +
+ + +
+
since v1.5
+

"gzip"

+
+ +
+
Description:
+
+

+Enables on-the-fly compression of HTTP response using gzip. + +

+ +Equivalent to compress: [ gzip ]. + +
+
Level:
+
global, host, path, extension
+
Default:
+
gzip: OFF
 +
See also:
+
compress +
+
+ + + + +
+ + + -- cgit v1.2.3