PHPackages                             david-dong/unified-upload - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [File & Storage](/categories/file-storage)
4. /
5. david-dong/unified-upload

ActiveLibrary[File & Storage](/categories/file-storage)

david-dong/unified-upload
=========================

多云存储上传组件，支持本地、腾讯云COS、阿里云OSS、七牛云

v1.0.4(2mo ago)011MITPHPPHP >=8.0

Since Apr 9Pushed 2mo agoCompare

[ Source](https://github.com/DavidDongs/unified-upload)[ Packagist](https://packagist.org/packages/david-dong/unified-upload)[ RSS](/packages/david-dong-unified-upload/feed)WikiDiscussions main Synced 3w ago

READMEChangelogDependencies (4)Versions (6)Used By (0)

unified-upload
==============

[](#unified-upload)

多云存储上传组件，支持本地、腾讯云 COS、阿里云 OSS、七牛云。

功能特性
----

[](#功能特性)

- 支持四种存储方式：本地、腾讯云 COS、阿里云 OSS、七牛云
- 统一的接口设计，便于扩展新的存储后端
- 支持文件上传、Base64 上传、文件删除
- 内置文件类型和大小验证
- 运行时动态切换存储方式
- 完善的错误处理和异常机制
- 详细的代码注释，方便理解
- 适配 ThinkPHP、Laravel、Hyperf 三大框架

支持的框架
-----

[](#支持的框架)

框架版本集成方式ThinkPHP8.xTraitLaravel9.x / 10.x / 11.xServiceProvider + TraitHyperf3.xConfig + Trait安装
--

[](#安装)

```
composer require david-dong/unified-upload
```

快速开始
----

[](#快速开始)

### ThinkPHP 8 集成

[](#thinkphp-8-集成)

#### 1. 使用配置文件

[](#1-使用配置文件)

手动复制 `vendor/david-dong/unified-upload/src/config/upload.php` 到 `config/upload.php`

#### 2. 配置环境变量

[](#2-配置环境变量)

在 `.env` 文件中添加：

```
# 默认存储类型：local, tencent_cos, aliyun_oss, qiniu
UPLOAD_DEFAULT_STORAGE=local

# 本地存储
UPLOAD_LOCAL_DOMAIN=http://localhost:8080/uploads
UPLOAD_LOCAL_ROOT_PATH=/var/www/uploads

# 腾讯云 COS
TENCENT_COS_SECRET_ID=your_secret_id
TENCENT_COS_SECRET_KEY=your_secret_key
TENCENT_COS_REGION=ap-beijing
TENCENT_COS_BUCKET=your_bucket

# 阿里云 OSS
ALIYUN_OSS_ACCESS_KEY_ID=your_access_key_id
ALIYUN_OSS_ACCESS_KEY_SECRET=your_access_key_secret
ALIYUN_OSS_ENDPOINT=oss-cn-hangzhou.aliyuncs.com
ALIYUN_OSS_BUCKET=your_bucket

# 七牛云
QINIU_ACCESS_KEY=your_access_key
QINIU_SECRET_KEY=your_secret_key
QINIU_BUCKET=your_bucket
QINIU_DOMAIN=your_domain
```

#### 3. 使用示例

[](#3-使用示例)

```