upload_pass_form_field
`upload_pass_form_field` 指令在请求中设置一个表单字段名，该字段将被填充为来自上传文件的特定值。
NGINX module for handling file uploads
·
httpserverlocationif in locationlimit_except
语法upload_pass_form_field field_name;
默认值none
上下文http, server, location, if in location, limit_except
参数1
说明
upload_pass_form_field 指令是 NGINX upload module 的一部分，该模块使用 multipart/form-data 编码来实现文件上传。该指令指定生成的请求体中将接收从上传文件中提取值的字段。当文件上传到服务器时，文件的原始内容会从请求体中移除，取而代之的是可以创建新的表单字段来包含从上传文件派生的结果。通过使用该指令，用户可以自定义随后发送到被代理的服务器或其他处理端点的请求数据，从而更精确地控制传输哪些文件数据以及这些数据如何表示。\n\n要正确使用此指令，应将其置于 location 块或其他适当的 server/上下文 配置中。该指令只需要一个参数，即要在请求体中设置的表单字段的名称。该指令与 NGINX upload module 中的其他指令（例如 upload_set_form_field）协同工作，后者实际定义如何用文件的值填充该表单字段。这为在 Web 应用中处理文件上传及其相关元数据提供了灵活的机制。
配置示例
location /upload {
upload_pass /process_upload;
upload_store /tmp/uploads;
upload_pass_form_field myFileField;
}⚠
确保在 upload_pass_form_field 中指定的字段名不会与应用程序中已有的字段名冲突。
⚠
请记得使用 "upload_set_form_field" 来指定如何用文件内容填充该字段。
⚠
仅当在像 location 或 server 这样的适当上下文中使用时，此指令才生效。