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

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

overphp/upload
==============

laravel-upload

1.0.7(7y ago)154MITPHPPHP >=7.0.0

Since Jul 16Pushed 7y agoCompare

[ Source](https://github.com/overphp/laravel-upload)[ Packagist](https://packagist.org/packages/overphp/upload)[ RSS](/packages/overphp-upload/feed)WikiDiscussions master Synced 2mo ago

READMEChangelog (3)Dependencies (3)Versions (10)Used By (0)

Laravel-upload 文件上传扩展包
----------------------

[](#laravel-upload-文件上传扩展包)

`laravel-upload` 是一个用于文件异步上传的扩展包。

安装
--

[](#安装)

### 安装扩展包

[](#安装扩展包)

```
// 引入扩展包
composer require "overphp/upload":"1.*"
composer update --prefer-dist

// 发布资源文件
// 发布包文件
php artisan vendor:publish --tag=laravel-upload

// 发布jquery上传插件（需要使用jquery.upload.js插件时发布）
// 可选
php artisan vendor:publish --tag=laravel-upload-assets

```

### 配置网络访问

[](#配置网络访问)

默认上传文件存储在`storage/app/public`目录下，如果需要上传文件能够通过网络访问，需要创建 `pulic/storage` 到 `storage/app/public` 的符号链接。

```
php artisan storage:link

```

参考

必须修改 `.env` 文件 "APP\_URL" 为实际的url，或者是设置为空（将会使用浏览器路径）

### 使用中间件实现上传权限管理

[](#使用中间件实现上传权限管理)

默认任何人可以上传文件,如果需要进行上传权限控制，请自行定义中间件，并在 `config/upload.php` 中修改 middleware 的值为定义的中间件名称。

```
 /**
   * 上传模块认证 middleware
   *
   * 文件上传需要的中间件名称，为空则允许任何用户上传文件
   */
   'middleware' => [],

```

参数配置
----

[](#参数配置)

参数配置参考 `config/upload.php` 及注释内容

使用上传后端
------

[](#使用上传后端)

#### 上传组件返回值示例

[](#上传组件返回值示例)

默认为`json`格式

```
{
    "status": true, // 上传结果  true | false
    "message": "Uploaded successfully.",
    "url": "/storage/file/20180717/63320412.png",
    "name": "63320412.png",
    "original": "avatar5.png",
    "extension": ".png",
    "size": 7578
}

```

#### 上传地址

[](#上传地址)

- 文件上传url：`/upload/file`
- 图片上传url: `/upload/image`

#### 自定义

[](#自定义)

请参考 `Overphp\Upload\Upload.php` 文件以及 `Overphp\Upload\UploadController.php` 文件。

结合jquery.upload.js插件使用
----------------------

[](#结合jqueryuploadjs插件使用)

`jquery.upload.js` 上传插件在 [jquery.fileupload.js](https://github.com/blueimp/jQuery-File-Upload) 插件基础上进行了简单封装。
同时依赖 `layer.js` 来进行加载层和消息提示。

#### 发布jquery.upload.js文件

[](#发布jqueryuploadjs文件)

如果需要修改插件发布的路径,可以修改`upload.assets_path`为需要的路径即可。

```
php artisan vendor:publish --tag=laravel-upload-assets

```

#### jquery.upload.js 参数说明

[](#jqueryuploadjs-参数说明)

名称类型必须示例值描述typestringfalseimage文件上传类型，默认：`file`,可选值:`image`、`file`。urlstringfalse文件上传url地址，默认为空，默认根据`type`参数自动设置,不为空时`type`参数无效。valstringtrue'#abc'文件上传成功后返回的文件url地址写入对象。srcstringtrue'#image'图片文件上传成功后返回的图片url地址写入 `img`标签对象，仅`type`为`image`时有效。callbackcallbackfalse自定义返回结果处理，使用本参数时，除了`type`属性，其他全部无效。loadboolfalsefalse是否显示加载层，默认显示#### 使用插件

[](#使用插件)

##### 文件上传

[](#文件上传)

```

// include jquery.js
@include('upload::upload')

	$(function(){
		$('#upfile').upload({val:'#file'});
	);

```

##### 图片上传

[](#图片上传)

```

// include jquery.js
@include('upload::upload')

	$(function(){
		$('#upfile').upload({
			type:'image' // 默认file，修改为 图片模式
			val:'#file', // 图片路径写入表单
			src:'#image' // 返回的图片路径写入img标签
		});
	);

```

#### 自定义回调

[](#自定义回调)

```

// include jquery.js
@include('upload::upload')

	$(function(){
		$('#upfile').upload({
			callback:function(res){
				// do something here
				// res 为json格式返回值
				// callback时，除了type参数，其余参数无效
			}
		});
	);

```

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity63

Established project with proven stability

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 ~19 days

Recently: every ~29 days

Total

8

Last Release

2722d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/279aecb8c218b7eaff15b50ecac3ec8c0832cd5ad851cb8531a8dcb752fd4bd8?d=identicon)[overphp](/maintainers/overphp)

###  Code Quality

TestsPHPUnit

### Embed Badge

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

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

###  Alternatives

[overtrue/laravel-filesystem-qiniu

A Qiniu storage filesystem for Laravel.

482229.7k16](/packages/overtrue-laravel-filesystem-qiniu)[rahulhaque/laravel-filepond

Use FilePond the Laravel way

261114.4k2](/packages/rahulhaque-laravel-filepond)[overtrue/laravel-filesystem-cos

A Cos storage filesystem for Laravel.

92128.4k7](/packages/overtrue-laravel-filesystem-cos)

PHPackages © 2026

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