concat_delimiter
`concat_delimiter` 指令设置用于在 HTTP 响应中分隔已合并文件的字符串。
HTTP Concatenation module for NGINX
·
httpserverlocation
语法concat_delimiter delimiter_string;
默认值none
上下文http, server, location
参数1
说明
concat_delimiter 指令是 NGINX 的 HTTP Concatenation 模块的一部分,允许在响应中被合并的文件之间指定用户定义的分隔符。该指令接受单个字符串参数,作为多个资源(例如 JavaScript 或 CSS 文件)合并到单个 HTTP 响应时的分隔符。使用该指令有助于更清晰地组织输出,尤其在客户端期望特定格式以便正确解析合并输出时非常有用。
可以在 http、server 或 location 上下文中使用 concat_delimiter 指令,从而在配置上提供灵活性。当设置该指令后,每当请求过程中合并文件时,指定的分隔符将插入到各文件内容之间。例如,如果将分隔符设置为分号(;),响应中会使用分号分隔合并的文件,而不是默认的直接拼接文件内容。这在调试场景中特别有用,或在处理可能需要特定分隔符以便客户端正确解析的 mime types 时也很有用。
配置示例
location /static/js/ {
concat on;
concat_delimiter ';';
}⚠
确保所选的分隔符不会与被拼接文件的内容冲突,因为这可能导致客户端解析错误。
⚠
应根据文件类型谨慎选择分隔符,以避免破坏功能,尤其是 JavaScript 和 CSS 文件。