PHPackages                             phpcode/tp51-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. phpcode/tp51-upload

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

phpcode/tp51-upload
===================

no Description is good Description!

v1.0.2(7y ago)11331MITPHP

Since Dec 24Pushed 7y ago1 watchersCompare

[ Source](https://github.com/bill-wangwang/tp51-upload)[ Packagist](https://packagist.org/packages/phpcode/tp51-upload)[ RSS](/packages/phpcode-tp51-upload/feed)WikiDiscussions master Synced 4d ago

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

tp51-upload
===========

[](#tp51-upload)

thinkphp5.1 聚合上传类

安装
--

[](#安装)

> composer require phpcode/tp51-upload

配置
--

[](#配置)

- 复制`examples/config/upload.php`到项目config配置目录下（`config/upload.php`）
- 修改`.env`文件（可参考文件`examples/.env.example`和`upload.php`）

使用
--

[](#使用)

### Controller 接收

[](#controller-接收)

```
use tp51\upload\Upload;
$upload = new Upload();
$res = $upload->uploadRemoteImage();
/*
$res = [
  'base_name' => 原始图片文件名(不含后缀)
  'name'=> 原始图片文件名(含后缀)
  'size'=> 图片的大小，单位为字节
  'url' => 图片的URL地址
  'width' => 图片的宽
  'height' => 图片的高
]
*/

```

支持
--

[](#支持)

- 阿里云的oss存储
- 腾讯云的cos存储
- 七牛云存储
- 本地存储

重要选项
----

[](#重要选项)

- `upload_type` 支持\[ `oss` 、 `cos` 、 `qiniu` 、 `local` \]
- `sub_dir` 子目录选项，如果不为空必须要以`/`结尾

功能
--

[](#功能)

- 灵活的配置（可以参考`Upload.php`的配置项`$_config`）
- 允许限制图片的大小(`image_max_size`)或`->setMaxSize()`
- 允许限制图片的格式(`image_format`)或`->setFormat()`
- 允许设置图片需要的最小宽度(`min_width`)或`->setMinWidth()`
- 允许设置图片需要的最大宽度(`max_width`)或`->setMaxWidth()`
- 允许设置图片需要的最小高度(`min_height`)或`->setMinHeight()`
- 允许设置图片需要的最大高度(`max_height`)或`->setMaxHeight()`
- 允许设置异常错误码(`exception_code`)
- 允许设置上传最大超时时间(`timeout`)
- 允许设置附件的格式(`format`)或`->setFormat($format, 'format')`
- 允许设置附件的最大大小(`max_size`)或`->setMaxSize($max_size, 'max_size')`

开放方法
----

[](#开放方法)

### 图片部分

[](#图片部分)

#### 常用

[](#常用)

- `uploadRemoteImage()` 上传远程表单图片，常见于web
- `uploadImageByContent()` 上传内存中的图片，常见于app和微信小程序的接口

#### 进阶

[](#进阶)

- `setUploadType()` 设置上传类型 支持\[ `oss` 、 `cos` 、 `qiniu` 、 `local` \]
- `setMaxSize()` 设置允许上传的图片的最大大小，单位为`字节`
- `setFormat()` 设置允许的图片格式，多个用`|`分割
- `setMinWidth()`设置图片需要的`最小宽度`，单位为`像素` 默认为`0`不限制
- `setMaxWidth()`设置图片需要的`最大宽度`，单位为`像素` 默认为`0`不限制
- `setMinHeight()`设置图片需要的`最小高度`，单位为`像素` 默认为`0`不限制
- `setMaxHeight()`设置图片需要的`最大高度`，单位为`像素` 默认为`0`不限制

### 附件部分

[](#附件部分)

#### 常用

[](#常用-1)

- `uploadFileByContent()`上传远程表单附件，常见于web
- `uploadRemoteFile()`上传内存中的风渐渐，常见于app和微信小程序的接口

#### 进阶

[](#进阶-1)

- `setUploadType()` 设置上传类型 支持\[ `oss` 、 `cos` 、 `qiniu` 、 `local` \]
- `setMaxSize($max_size, 'max_size')` 设置允许上传的附件的最大大小，单位为字节
- `setFormat($format, 'format')` 设置允许的附件格式，多个用`|`分割

###  Health Score

29

—

LowBetter than 59% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity12

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~8 days

Total

3

Last Release

2683d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/fec3df0815ef02996bc06e57f87a266c1c9345ab51497ace14ff1bda9988de1b?d=identicon)[bill-wangwang](/maintainers/bill-wangwang)

---

Top Contributors

[![bill-wangwang](https://avatars.githubusercontent.com/u/14326461?v=4)](https://github.com/bill-wangwang "bill-wangwang (9 commits)")

### Embed Badge

![Health badge](/badges/phpcode-tp51-upload/health.svg)

```
[![Health](https://phpackages.com/badges/phpcode-tp51-upload/health.svg)](https://phpackages.com/packages/phpcode-tp51-upload)
```

###  Alternatives

[yangyifan/upload

上传 SDK for Laravel

12422.6k3](/packages/yangyifan-upload)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)