PHPackages                             naux/laravel-oss - 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. naux/laravel-oss

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

naux/laravel-oss
================

1.3(11y ago)281598PHPPHP >=5.4.0

Since Jan 28Pushed 7y ago2 watchersCompare

[ Source](https://github.com/NauxLiu/Laravel-Oss)[ Packagist](https://packagist.org/packages/naux/laravel-oss)[ RSS](/packages/naux-laravel-oss/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (1)Dependencies (2)Versions (5)Used By (0)

Laravel-Oss
===========

[](#laravel-oss)

专用于Laravel的阿里云OSS扩展包

安装
--

[](#安装)

#### 添加依赖

[](#添加依赖)

添加

```
"naux/laravel-oss": "1.*"

```

到你的`composer.json`文件的`require`中, 执行`composer install` 或 `composer update`。

#### 注册Provider

[](#注册provider)

在你的 `config/app.php`文件 `providers`数组中中添加`'Naux\LaravelOss\LaravelOssServiceProvider'`。

#### 配置

[](#配置)

执行命令`php artisan config:publish naux/laravel-oss`
然后到`app/config/packages/naux/laravel-oss/config.php`文件中按照注释修改配置。

实例
--

[](#实例)

```
//删除bucket foo下的bar对象
OSS::bucket('foo')->delete('bar');

//上面选择了bucket，后面的操作都不用重复

//上传请求中的文件
OSS::upload('foobar', Input::file('image'));

//取得directory目录下的所有对象信息
foreach(OSS::files('directory') as $file){
	//do something
}
```

使用
--

[](#使用)

#### 获取原生OSSClient对象

[](#获取原生ossclient对象)

```
OSS::getClient();

```

#### 选择bucket

[](#选择bucket)

```
OSS::bucket('foo');
```

> 如果在配置文件中设置了`default`字段，就不需要选择

#### 删除bucket

[](#删除bucket)

```
OSS::bucket('foo')->destroy();
```

#### 创建新的bucket

[](#创建新的bucket)

```
OSS::create('foo');

//创建bucket同时设置权限
OSS::create('foo', 'public');
```

权限选项：

1. `private`私有（默认）
2. `public-read`公共读
3. `public-read-write` 公共读写

#### 获取所有bucket

[](#获取所有bucket)

```
//当前账号拥有的所有bucket
OSS::buckets();
```

#### 上传文件

[](#上传文件)

```
//根据路径上传文件
OSS::upload('foobar', '/temps/file');

//上传文件,同时设置其他信息
OSS::upload('foobar', '/temps/file', [
	'Expires' => new \DateTime("+5 minutes"),
	'Content-Type' => 'foo',
	//...
]);

//上传请求中的文件
OSS::update('foobar', Input::file('foobar'));
```

> 使用`Input::file()`上传的文件，会被自动设置`ContentType`

#### 删除object

[](#删除object)

```
OSS::delete('object_key');

//同时删除多个
OSS::delete(['object_key1', 'object_key2']);
```

#### 拷贝Object

[](#拷贝object)

```
OSS::copy('from', 'to');

//从当前的bucket拷贝到其他bucket
OSS::copy('from', 'to', 'another_bucket');
```

#### 移动Object

[](#移动object)

```
OSS::move('from', 'to');

//从当前的bucket其他bucket并重命名
OSS::move('from', 'to', 'another_bucket');
```

#### 获取所有Object列表

[](#获取所有object列表)

```
OSS::objects();

//方法声明
//public function objects($start = 0, $limit = 100, $prefix = '', $delimiter = ''){}
```

参数 [参考文档](http://aliyun_portal_storage.oss.aliyuncs.com/oss_api/oss_phphtml/object.html#id7)

#### 获取指定目录下Object列表

[](#获取指定目录下object列表)

```
//获得temps目录下所有object列表
OSS::files('temps');
```

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity22

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity61

Established project with proven stability

 Bus Factor1

Top contributor holds 94.4% 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 ~4 days

Total

4

Last Release

4108d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/22071ff5935f95277f8b0c794c2f23703e6de307ed0e65e25e7c3a878a45c012?d=identicon)[NauxLiu](/maintainers/NauxLiu)

---

Top Contributors

[![nauxliu](https://avatars.githubusercontent.com/u/9570112?v=4)](https://github.com/nauxliu "nauxliu (17 commits)")[![Kuri-su](https://avatars.githubusercontent.com/u/22676438?v=4)](https://github.com/Kuri-su "Kuri-su (1 commits)")

### Embed Badge

![Health badge](/badges/naux-laravel-oss/health.svg)

```
[![Health](https://phpackages.com/badges/naux-laravel-oss/health.svg)](https://phpackages.com/packages/naux-laravel-oss)
```

###  Alternatives

[aws/aws-sdk-php-laravel

A simple Laravel 9/10/11/12/13 service provider for including the AWS SDK for PHP.

1.7k35.6M75](/packages/aws-aws-sdk-php-laravel)[illuminate/filesystem

The Illuminate Filesystem package.

15261.6M2.6k](/packages/illuminate-filesystem)[stechstudio/laravel-zipstream

A fast and simple streaming zip file downloader for Laravel.

4633.7M3](/packages/stechstudio-laravel-zipstream)[spatie/laravel-google-cloud-storage

Google Cloud Storage filesystem driver for Laravel

2408.9M13](/packages/spatie-laravel-google-cloud-storage)[azure-oss/storage-blob-laravel

Azure Storage Blob filesystem driver for Laravel

63582.2k1](/packages/azure-oss-storage-blob-laravel)[spatie/laravel-backup-server

Backup multiple applications

17016.7k1](/packages/spatie-laravel-backup-server)

PHPackages © 2026

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