upload_tame_arrays
`upload_tame_arrays` 指令控制在 NGINX 中上传的文件数组是否转换为字符串值。
NGINX module for handling file uploads
·
httpserverlocationif in locationlimit_except
语法upload_tame_arrays on | off;
默认值off
上下文http, server, location, if in location, limit_except
参数flag
说明
upload_tame_arrays 指令在 NGINX 上传模块中用于配置上传的文件数组。当设置为 'on' 时，该指令会修改文件上传的行为：如果在同一字段名下上传了多个文件，它们将使用合适的分隔符连接为单个字符串值。在某些不需要数组结构的应用场景中，这有助于简化对上传数据的访问。相反，当设置为 'off' 时，模块将保留文件数组的默认结构，虽然可能导致对上传文件的处理更复杂，但保留了原始形式并可以单独访问每个文件。
在应用此指令时，请根据使用上下文决定，因为从默认的数组行为更改可能会影响后端脚本或应用程序对传入数据的解释。是否使用此指令应考虑下游进程主要如何消费上传的文件数据——它们是期望单个字符串条目还是文件数组。此外，此配置也可能影响可断点续传上传中文件分片的处理。
配置示例
server {
location /upload {
upload_pass /upload/process;
upload_tame_arrays on;
upload_store /tmp/uploads;
}
}⚠
将指令从 'off' 更改为 'on' 可能会导致期望数组结构的后端应用出现故障。
⚠
请确保用于拼接字符串的分隔符不会与文件名的实际内容冲突。