Yii2上传组件通过定义StorageInterface接口及OssStorage实现类，配合配置注册和控制器逻辑改造，可无缝切换至阿里云OSS存储。
你需要让Yii2的上传组件支持自定义存储驱动，比如把文件存到阿里云OSS而非本地磁盘，但官方Upload类只默认写入upload目录，硬编码路径无法切换。
创建自定义存储驱动接口
在@common/components/storage下新建StorageInterface.php，定义统一方法签名：
interface StorageInterface { public function save($content, $path); public function getUrl($path); public function delete($path); }
这一步必须做，否则后续所有驱动无法被统一调用——【接口契约缺失会导致上传逻辑散落在各处，后期替换存储服务时需逐个改控制器】。
实现阿里云OSS驱动
在相同目录下新建OssStorage.php，继承yiiaseComponent并实现接口：
先安装SDK：composer require aliyuncs/oss-sdk-php；
然后写驱动类：
use AlibabaCloudOSSOSSClient; class OssStorage extends Component implements StorageInterface { public $accessKeyId; public $accessKeySecret; public $endpoint; public $bucket; public function init() { parent::init(); if (empty($this->accessKeyId) || empty($this->accessKeySecret)) { throw new InvalidConfigException('OSS config missing'); } } public function save($content, $path) { $oss = new OSSClient($this->accessKeyId, $this->accessKeySecret, $this->endpoint); $oss->putObject($this->bucket, $path, $content); return true; } public function getUrl($path) { return "https://{$this->bucket}.{$this->endpoint}/{$path}"; } public function delete($path) { $oss = new OSSClient($this->accessKeyId, $this->accessKeySecret, $this->endpoint); $oss->deleteObject($this->bucket, $path); } }
注册为应用组件
打开config/web.php，在components数组中添加：
'storage' => [ 'class' => 'common\components\storage\OssStorage', 'accessKeyId' => 'your-key-id', 'accessKeySecret' => 'your-key-secret', 'endpoint' => 'oss-cn-hangzhou.aliyuncs.com', 'bucket' => 'my-bucket-name', ],
注意：配置项必须全部小写，驼峰命名会失效；【endpoint末尾不能带http://或https://，否则OSS SDK初始化失败】。
改造上传逻辑使用新驱动
第一步：修改模型的rules()，去掉'file'验证器里的'skipOnEmpty' => true——它会让空文件跳过验证，但OSS上传不允许空内容；
第二步：在控制器中替换原生saveAs()调用：
$file = UploadedFile::getInstance($model, 'file'); if ($file) { $content = file_get_contents($file->tempName); $path = 'uploads/' . uniqid() . '.' . $file->extension; Yii::$app->storage->save($content, $path); $model->file_url = Yii::$app->storage->getUrl($path); }
这一步操作起来很简单，直接把文件拖进去就行。但要注意：不要用$file->saveAs()，它只会写本地；也不要用Yii::setAlias('@uploads', '@webroot/uploads')这类别名，OSS不需要物理路径。
扩展兼容性适配
方法一：给现有上传组件（如kartik FileInput）加钩子
在FileInput::widget()的pluginOptions里传入'uploadUrl' => Url::to(['/upload/handle'])，后端控制器中调用Yii::$app->storage->save()即可；
方法二：封装通用上传服务类
新建common/services/Uploader.php，构造函数注入StorageInterface，对外提供upload($file, $prefix = 'default')方法；
方法三：重写UploadedFile类的saveAs()行为（不推荐）
通过PHP的class_alias()覆盖原始类，风险高且升级时易冲突，仅限临时调试。
