nginx中文文档-ngx_http_xslt_module

ngx_http_xslt_module模块(0.7.8+)是一个过滤器,用于使用一个或多个XSLT 样式表改变XML响应样式。该模块默认不会构建,需要通过–with-http_xslt_module配置参数开启。该模块需要libxml2和libxslt库。

示例配置

location / {
    xml_entities    /site/dtd/entities.dtd;
    xslt_stylesheet /site/xslt/one.xslt param=value;
    xslt_stylesheet /site/xslt/two.xslt;
}

xml_entities

语法:xml_entities path
默认:—
上下文:http, server, location

指定DTD文件声明实体字符。这个文件在配置阶段编译。由于技术原因,这个模块不能使用声明在处理过的XML中的外部子集,所以它会被忽略,然后使用一个特殊定义的文件替代它。文件不应该描述XML结构。它只声明需要的实体字符就够了,例如:
<!ENTITY nbsp "&#xa0;">

xslt_last_modified

语法:xslt_last_modified on | off
默认:xslt_last_modified off
上下文:http, server, location
版本:1.5.1+

允许在XSLT转换期间从原始响应头中保留“Last-Modified”字段,有助于缓存响应。
默认情况下,头域会被删除,因为在转换过程中,响应的内容改变了,可能包含动态生成的元素或与原始请求不同的部分。

xslt_param

语法:xslt_param parameter value
默认:—
上下文:http, server, location
版本:1.1.18+

定义XSLT样式表的参数。值看做是一个XPath表达式。值可以包含变量。为了传递字符串值到样式表,可以使用xslt_string_param指令。
可以有多个xslt_param指令。这些指令当且仅当当前层级中没有定义xslt_param和xslt_string_param指令时会继承自上一层级。

xslt_string_param

语法:xslt_string_param parameter value
默认:—
上下文:http, server, location
版本:1.1.18+

为XSLT样式表定义字符串参数。值中的XPath表达式是不被理解的。值可以包含变量。
可以有多个xslt_string_param指令。这些指令当且仅当当前层级中没有定义xslt_param和xslt_string_param指令时,会继承自上一层级。

xslt_stylesheet

语法:xslt_stylesheet stylesheet [parameter=value …];
默认:—
上下文:location

定义XLST样式表和它的可选参数。样式表在配置阶段编译。
参数可以是分开的,也可是聚合在同一行使用“:”分割。如果参数包含“:”字符,需要转义为“%3A”。同样libxslt需要将包含非字母数字的字符用单引号或双引号包裹起来,例如:
param1='http%3A//www.example.com':param2=value2
参数描述可以包含变量,例如整行的参数可以从一个变量中取:

location / {
    xslt_stylesheet /site/xslt/one.xslt
                    $arg_xslt_params
                    param1='$value1':param2=value2
                    param3=value3;
}

可以指定多个样式表。它们会按指定时的顺序应用。

xslt_types

语法:xslt_types mime-type
默认:xslt_types text/xml
上下文:http, server, location

对指定除了“text/xml”意外的MIME类型的响应启用转换。特殊值“*”匹配任意MIME类型(0.8.29+)。如果转换结果是一个HTML响应,它的MIME类型变更为“text/html”。

nginx中文文档-ngx_http_v2_module

此页面版本:2016-06-08
ngx_http_v2_module模块(1.9.5+)提供了HTTP2协议的支持,并取代ngx_http_spdy_module模块。该模块默认不会构建,需要通过–with-http_v2_module参数启用。

已知问题
该模块为实验性的。
在1.9.14版本以前,客户端请求体的缓冲区不能够禁用,不管proxy_request_buffering, fastcgi_request_buffering, uwsgi_request_buffering 和 scgi_request_buffering指令的值。

示例配置

server {
    listen 443 ssl http2;

    ssl_certificate server.crt;
    ssl_certificate_key server.key;
}

注意接受TLS上的HTTP2连接需要“Application-Layer Protocol Negotiation”(ALPN)TLS扩展支持,仅从OpenSSL1.0.2版本开始可用。使用“Next Protocol Negotiation”(NPN)TLS扩展(从OpenSSL1.0.1版本可用)的不能保证。
还要注意,如果ssl_prefer_server_ciphers指令设置的值为“on”,加密算法需要遵从RFC7540 附录A黑名单,并受客户端支持。

http2_chunk_size

语法:http2_chunk_size size
默认:http2_chunk_size 8k
上下文:http, server, location

设置响应体被分割的最大块大小。过小的值会导致更高的负荷。太高的值由于排头阻塞对优化有害。

http2_body_preread_size

语法:http2_body_preread_size size
默认:http2_body_preread_size 64k;
上下文:http, server
版本:1.11.0+

设置每一个请求的缓冲区大小,请求体在开始处理前可以保存到缓冲区中

http2_idle_timeout

语法:http2_idle_timeout time
默认:http2_idle_timeout 3m
上下文:http, server

设置非活跃的超时时间,过了这个时间后连接将被关闭。

http2_max_concurrent_streams

语法:http2_max_concurrent_streams number
默认:http2_max_concurrent_streams 128
上下文:http, server

设置一个连接中同时传输HTTP2流的最大数。

http2_max_field_size

语法:http2_max_field_size size
默认:http2_max_field_size 4k
上下文:http, server

限制HPACK压缩请求头域的最大大小。限制应用于名字和值。注意如果使用哈夫曼编码,实际的解压的名字和值的字符串大小可能更大。对于大多数请求,默认的限制是足够的。

http2_max_header_size

语法:http2_max_header_size size
默认:http2_max_header_size 16k
上下文:http, server

限制在HPACK解压后完整的请求头列表的最大大小。对于大多数请求来说,默认的限制是足够的。

http2_recv_buffer_size

语法:http2_recv_buffer_size size
默认:http2_recv_buffer_size 256k
上下文:http

设置接收缓冲区的大小。

http2_recv_timeout

语法:http2_recv_timeout time
默认:http2_recv_timeout 30s
上下文:http, server

为希望从客户端收到更多数据设置超时时间,超过这个时间之后连接将关闭。

内嵌变量
ngx_http_v2_module模块支持以下内嵌变量:

$http2
协商协议标识符:TLS上的HTTP2为“h2”,明文TCP的HTTP2为“h2c”,其他的为空。