uploadbehavior类通过绑定beforevalidate和aftersave事件，自动处理文件校验、路径生成、重命名与保存，支持单/多文件上传，要求属性声明为uploadedfile类型，uploadpath必须使用@webroot等别名而非绝对路径。
你需要在Yii2项目中配置上传行为，让文件上传不再依赖硬编码路径、手动创建目录或反复写saveAs逻辑——而是通过统一的行为绑定，自动处理验证、存储、重命名和路径生成。
定义UploadBehavior类并注册到模型
新建文件 common/components/UploadBehavior.php，继承 yii\base\Behavior，重写 events() 方法绑定 beforeValidate 和 afterSave 事件。
在 beforeValidate 中调用 $this->owner->validateFileAttribute($attribute) 执行扩展名、大小等校验；在 afterSave 中执行 $file->saveAs($this->getUploadPath() . $this->generateFileName($file))。
关键点在于：该行为不接管模型属性赋值，只负责“有文件上传时才触发”，【必须确保模型中对应属性已声明为 UploadedFile 类型】，否则 getInstanceByName 会返回 null。
配置上传路径与命名规则
在行为配置中设置 uploadPath 为相对路径（如 'uploads/{yyyy}/{mm}'），行为内部会自动用 Yii::getAlias('@webroot') 拼出绝对路径。
日期占位符 {yyyy}、{mm}、{dd} 会被自动替换为当前年月日；{rand:6} 生成6位随机数，避免同名覆盖。
不要把 uploadPath 写成 /var/www/html/uploads/ 这类绝对路径——行为无法感知运行环境，且不同部署（Docker/本地/测试）路径不一致，【必须使用 @webroot 或 @runtime 别名】。
绑定行为到模型的三种方式
方法一：在模型类的 behaviors() 方法中静态绑定
return ['upload' => ['class' => UploadBehavior::class, 'attribute' => 'avatar', 'uploadPath' => 'uploads/avatar/{yyyy}/{mm}']]；
方法二：运行时动态附加（适用于同一模型多个上传字段需不同配置）
$model->attachBehavior('coverUpload', new UploadBehavior(['attribute' => 'cover_image', 'uploadPath' => 'uploads/cover/{yyyy}/{mm}/{dd}']));
方法三：在控制器中临时启用（仅用于一次性上传，如后台临时导入）
$model->attachBehavior('tempUpload', UploadBehavior::create(['attribute' => 'temp_file', 'allowExtensions' => ['csv', 'xlsx']]))；
处理多文件上传的完整流程
第一步：模型中声明数组属性并配置多文件验证规则
public $files;
第二步：在 rules() 中添加 ['files', 'file', 'maxFiles' => 10, 'extensions' => 'jpg,png,pdf', 'skipOnEmpty' => true]；注意 skipOnEmpty 必须设为 true，否则空数组会触发验证失败。
第三步：视图中使用 $form->field($model, 'files[]')->fileInput(['multiple' => true]) 渲染多选输入框；【name 属性末尾必须带 []，否则后端只能拿到第一个文件】。
第四步：控制器中调用 $files = UploadedFile::getInstances($model, 'files') 获取全部实例，再逐个传给行为触发保存。
