在Yii2中实现文件上传后自动触发业务逻辑，需配置FileInput异步上传、编写UploadController处理文件保存与数据库写入、返回标准JSON响应，并通过队列异步执行耗时任务，最后用事件机制同步主表数据。
在Yii2项目中实现文件上传后自动触发业务逻辑处理，需要让前端上传动作与后端数据状态保持实时一致，避免用户重复提交或页面卡死。
配置FileInput插件启用异步上传
安装kartik-v/yii2-widget-fileinput插件：运行composer require kartik-v/yii2-widget-fileinput "@dev"命令。
确保模型中定义了文件属性，并在rules()里启用'skipOnEmpty' => true，否则空文件会直接校验失败导致异步中断。
视图中使用ActiveForm渲染FileInput控件，必须设置'multiple' => true和'pluginOptions' => ['uploadUrl' => '/upload/handler']，否则回调地址不会生效。
【uploadUrl必须指向一个不经过CSRF验证的控制器动作】，否则AJAX请求会被拦截并返回400错误。
编写异步上传处理器
创建UploadController.php，在actionHandler()中接收POST数据：
第一步：调用UploadedFile::getInstancesByName('file')获取全部上传文件对象，不能用getInstance，否则只取第一个。
第二步：遍历每个文件，执行$file->saveAs($path . '/' . $file->baseName . '.' . $file->extension)保存到指定目录。
第三步：将每张图片路径写入数据库images表，同时记录module字段标识来源模块，该字段后续用于权限过滤和删除隔离。
第四步：构造JSON响应体，包含initialPreview（已上传缩略图数组）、initialPreviewConfig（对应操作按钮配置）和uploadExtraData（如关联ID），缺一不可，否则预览区无法回显。
绑定上传成功回调函数
方法一：在FileInput插件初始化时传入'pluginEvents'参数：
'pluginEvents' => [ "fileuploaded" => "function(event, data) { console.log(data.response); }" ]
方法二：在页面底部用jQuery绑定全局事件：
$(document).on('fileuploaded', '#banner-input', function(event, data) { $('#hidden-field').val(data.response.ids); });
注意：回调函数内必须通过data.response读取后端返回的JSON，不要尝试从event.target提取值，那只是DOM节点。
实现上传状态与数据库实时同步
① 在UploadController::actionHandler()中，所有文件保存成功后，统一生成一条主记录到upload_log表，包含session_id、status = 1（处理中）和created_at时间戳。
② 启动一个后台任务（如yii\queue），将图片解析、水印添加、缩略图生成等耗时操作放入队列，避免阻塞HTTP响应。
③ 队列任务执行完毕后，更新upload_log表的status = 2（已完成），并触发Yii::$app->trigger('upload.finished', new UploadEvent(['logId' => $logId]))事件。
④ 在监听器中调用业务模型的refreshFromUploadLog($logId)方法，拉取最新图片列表并同步到商品/文章等主表关联字段。
