upload_progress_json_output
指令 `upload_progress_json_output` 可启用以 JSON 格式输出上传进度信息。
NGINX upload progress tracking module
·
httpserverlocation
语法upload_progress_json_output;
默认值none
上下文http, server, location
参数none
说明
upload_progress_json_output 指令是 NGINX 上传进度跟踪模块的一部分,该模块便于监控文件在传输到后端服务器时的上传过程。当使用此指令时,上传进度可以以 JSON 格式检索,适合集成到 JavaScript 应用中。该 JSON 输出允许开发者接收详细的进度数据,可在客户端界面上显示以向用户反馈上传状态。它与其他指令配合工作,尤其是 upload_progress,后者必须配置为使用指定的共享内存区和超时时间来跟踪进度。如果没有该配置,则不会有进度跟踪数据可用。
配置示例
location /upload {
upload_progress name 1m;
upload_progress_json_output;
}⚠
请确保使用 upload_progress 指令启用上传进度跟踪,否则将无法获得任何进度数据。
⚠
JSON 响应依赖于活动的上传跟踪;如果没有有效的上传进度标识符,响应可能为空。
⚠
确保您的应用程序正确处理 JSON 解析,以避免运行时错误。