ssi_types
NGINX 中的 'ssi_types' 指令指定应为服务器端包含 (SSI) 处理的文件的媒体类型。 — NGINX HTTP Core
ssi_types
httpserverlocation
语法ssi_types type1 [type2 ...];
默认值text/html text/shtml;
上下文http, server, location
模块NGINX HTTP Core
参数1+
说明
'ssi_types' 指令用于定义在 NGINX 中哪些文件类型有资格进行服务器端包含 (SSI) 处理。默认情况下,仅对 HTML 和 SHTML 文件进行 SSI 处理,以避免不必要地解析不需要此功能的其他文件类型。此指令允许用户扩展文件类型集合,确保任何指定的文件类型都可以包含 SSI 命令。该指令接受一个或多个 MIME types 作为参数,可在 http、server 或 location 上下文中配置。例如,如果希望在这些类型的文件中包含 SSI,可以添加像 'text/xml' 或 'application/json' 之类的类型。 当 NGINX 服务器遇到具有 'ssi_types' 中指定的关联 MIME 类型的文件时,它会对该文件执行 SSI 指令处理。该指令在需要在各种格式中包含包含命令的动态 Web 应用中尤其有用。然而,在将 SSI 扩展到非 HTML 类型时应谨慎,因为这可能会通过解析可能不需要 SSI 的文件而增加服务器的处理负担。此外,应注意适当的内容协商,以确保正确的类型被提供并得到适当处理。
配置示例
location /includes {
ssi on;
ssi_types text/xml application/json;
}⚠
确保正确包含所需的 MIME 类型;拼写错误会导致无法处理。
⚠
请记住,对许多文件类型启用 SSI 可能会增加服务器负载和响应时间。
⚠
别忘了在 location block 中或全局启用 SSI 才能生效。