Yii2中文件上传行为需按场景动态控制：注册时强制上传、编辑时可选、批量导入时忽略；通过behaviors()条件实例化UploadBehavior、rules()用'on'指定场景规则、控制器中按场景调用upload()并确保save()在上传后执行。
你需要在Yii2中让文件上传行为只在特定场景下生效，比如注册时必须上传头像、编辑资料时可选上传、后台批量导入则完全跳过验证——这些不能靠全局配置硬编码，得靠场景控制动态开关。
定义上传行为并绑定场景
在模型类（如 User.php）中新建一个行为类，例如 UploadBehavior，继承 yii\base\Behavior；该类需声明 events() 方法，但【不在此处注册任何事件】，因为事件绑定要由场景控制逻辑决定。
在模型的 behaviors() 方法中，返回一个带条件判断的数组：当 $this->scenario === 'register' 时才实例化上传行为，其他场景返回空数组或跳过。
这一步不能写成 return [UploadBehavior::className()] 这种无条件写法，否则所有场景都会触发上传校验，连API接口调用也会卡在文件检查上。
上传字段规则按场景分离
方法一：在 rules() 中用 'on' => 'register' 限定上传字段必填
[['avatar'], 'file', 'extensions' => 'jpg,png,gif', 'maxSize' => 2097152, 'on' => 'register']
方法二：对同一字段设置不同场景下的不同规则
[['avatar'], 'file', 'extensions' => 'jpg,png', 'on' => 'update'] → 编辑时允许上传但不强制
[['avatar'], 'safe', 'on' => 'import'] → 批量导入场景下彻底忽略该字段，防止 load() 报错
注意：'safe' 在 import 场景里不是摆设——它确保字段能被 load() 接收却不参与任何验证，否则 load() 会因未定义规则而静默丢弃数据。
控制器中触发上传逻辑
第一步：根据业务动作明确指定场景
$model = new User(['scenario' => 'register']); 或 $model->scenario = 'update';
第二步：仅当场景匹配上传要求时才执行 upload()
if ($model->scenario === 'register' && $model->validate()) { $model->upload(); }
第三步：避免在 save() 前盲目调用上传——upload() 内部若依赖 $model->id（如按ID建子目录），而此时 save() 尚未执行，$model->id 为空，会导致路径错误或文件写入失败。
第四步：上传成功后，手动赋值给模型属性（如 $model->avatar = $fileName;），再调用 $model->save() 持久化路径信息。
