在Yii2中实现文件上传并自动保存到数据库字段，必须将上传行为绑定到AR模型的behaviors()方法，通过FileUploadBehavior确保attribute与数据库字段名一致，并在beforeSave中调用upload()且校验其返回值以中断失败流程；需用事务包裹save()操作，上传成功后再提交，避免不一致；上传后在afterSave中清理临时文件。
在Yii2中实现文件上传并自动保存到数据库字段，必须让上传行为与ActiveRecord的save生命周期严格对齐，否则会出现文件已存但数据库未更新、或数据库已写入但文件丢失等不一致问题。
上传行为绑定到AR模型
在AR类中声明behaviors()方法，返回包含FileUploadBehavior的配置数组。
使用yii\behaviors\FileUploadBehavior（需先安装yii2-flysystem或yii2-uploadbehavior扩展），确保behavior配置中指定attribute为实际存储文件路径的字段名，例如'avatar'。
【attribute必须与AR模型中定义的字段名完全一致，且该字段需存在于对应数据表中】
若字段不存在，save()会静默跳过该字段赋值，不会报错，但数据库中对应列将保持NULL或默认值。
覆盖beforeSave确保上传执行时机
第一步：在AR类中重写beforeSave()方法，调用parent::beforeSave($insert)获取基础校验结果。
第二步：仅当父类返回true时，才执行$this->upload()——这是FileUploadBehavior提供的上传入口方法。
第三步：检查$this->upload()返回值是否为true；若为false，说明上传失败（如文件过大、类型不符、磁盘满），此时应手动return false中断保存流程。
这一步不能省略：不拦截上传失败会导致数据库记录被创建或更新，但关联文件路径为空或错误，后续读取时必然404。
处理事务与回滚一致性
方法一：手动开启事务包裹save()调用
在控制器中获取$db = Yii::$app->db→beginTransaction()→try块内执行$model->save()→成功则$transaction->commit()，失败则$transaction->rollBack()。
方法二：利用AR内置事务支持（仅适用于单模型+关联模型批量操作）
在AR类中重写transactions()方法，返回['*' => self::OP_INSERT . self::OP_UPDATE]，使所有增改操作自动包裹在事务中。
【FileUploadBehavior本身不参与事务管理，文件系统操作不可回滚，因此必须确保上传成功后再提交数据库事务】
上传后自动清理临时文件
在AR类中重写afterSave()方法，判断$isInsert或$isUpdate为true时，检查原始$_FILES是否残留临时路径。
调用unlink()删除$_FILES['xxx']['tmp_name']（仅当上传成功且模型已持久化后执行）。
这一步必须放在afterSave里，不能放beforeSave或upload()内部——否则上传失败时临时文件也被删，无法重试。
