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

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

i94m/laravel-filesystem-oss
===========================

Tencent Cloud OSS filesystem for Laravel

1.0.0(9mo ago)15MITPHPPHP ^8.0

Since Aug 5Pushed 9mo agoCompare

[ Source](https://github.com/wqf100124/laravel-filesystem-oss)[ Packagist](https://packagist.org/packages/i94m/laravel-filesystem-oss)[ RSS](/packages/i94m-laravel-filesystem-oss/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (3)Versions (3)Used By (0)

Laravel Filesystem OSS
======================

[](#laravel-filesystem-oss)

腾讯云对象存储（OSS）Laravel 文件系统驱动

介绍
--

[](#介绍)

Laravel Filesystem OSS 是一个为 Laravel 应用程序提供的阿里云云对象存储。

安装
--

[](#安装)

```
composer require i94m/laravel-filesystem-oss
```

配置
--

[](#配置)

### 1. 发布配置文件（可选）

[](#1-发布配置文件可选)

```
php artisan vendor:publish --provider="I94m\LaravelFilesystemOss\OssServiceProvider"
```

### 2. 配置环境变量

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

在 `.env` 文件中添加以下配置：

```
# 腾讯云对象存储
OSS_ACCESS_KEY_ID=
OSS_ACCESS_KEY_SECRET=
OSS_REGION=ap-guangzhou
OSS_ENDPOINT=oss-cn-guangzhou.aliyuncs.com
OSS_BUCKET=
OSS_PREFIX=
OSS_URL=
```

### 3. 配置文件系统

[](#3-配置文件系统)

在 config/filesystems.php 中添加 OSS 磁盘配置：

```
'disks' => [
    // ... 其他磁盘配置
    'oss' => [
        'driver' => 'oss',
        'access_key_id' => env('OSS_ACCESS_KEY_ID'),
        'access_key_secret' => env('OSS_ACCESS_KEY_SECRET'),
        'region' => env('OSS_REGION'),
        'endpoint' => env('OSS_ENDPOINT'),
        'bucket' => env('OSS_BUCKET'),
        'prefix' => env('OSS_PREFIX', ''),
        'url' => env('OSS_URL'),
    ],
],
```

使用方法
----

[](#使用方法)

### 基本文件操作

[](#基本文件操作)

```
use Illuminate\Support\Facades\Storage;

// 检查文件是否存在
Storage::disk('oss')->exists('file.txt');
// 删除文件
Storage::disk('oss')->delete('file.txt');
// 写入文件
Storage::disk('oss')->put('file.txt', 'Hello World');
// 读取文件
Storage::disk('oss')->get('file.txt');
// 更新文件
Storage::disk('oss')->put('file.txt', 'Updated Content');
// 追加文件
Storage::disk('oss')->append('file.txt', 'Appended Content');
// 获取文件列表
Storage::disk('oss')->files();
// 获取文件信息
Storage::disk('oss')->getMetadata('file.txt');
// 获取文件大小
Storage::disk('oss')->size('file.txt');
// 获取文件MIME类型
Storage::disk('oss')->mimeType('file.txt');
// 获取文件最后修改时间
Storage::disk('oss')->lastModified('file.txt');
```

### 获取临时上传密钥

[](#获取临时上传密钥)

```
Storage::disk('oss')->getAdapter()->sts([
    // 前缀
    'prefix' => 'prefix/if/needed',
    // 有效期(秒)
    'expire' => 3600,
    // 最大文件大小(bytes)
    'max_file_size' => 200,
    // 上传成功后返回状态码
    'success_action_status' => 201,
]);
```

返回结果：

```
{
  "url": "https://test-2025.oss-cn-hangzhou.aliyuncs.com",
  "payload": {
    "policy": "eyJl**********",
    "x-oss-signature-version": "OSS4**********",
    "x-oss-credential": "LTAI**********",
    "x-oss-date": "20250805T061257Z",
    "x-oss-signature": "15da**********",
    "success_action_status": "201"
  }
}
```

参考官方文档：

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance58

Moderate activity, may be stable

Popularity7

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity42

Maturing project, gaining track record

 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

Unknown

Total

1

Last Release

280d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/f2406a74aa540aabd8b767feffb4df73429e8a4f1d0eaba199cfaa987145df2a?d=identicon)[i94m](/maintainers/i94m)

---

Top Contributors

[![rtwadewang](https://avatars.githubusercontent.com/u/238177657?v=4)](https://github.com/rtwadewang "rtwadewang (1 commits)")

### Embed Badge

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

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

###  Alternatives

[unisharp/laravel-filemanager

A file upload/editor intended for use with Laravel 5 to 10 and CKEditor / TinyMCE

2.2k3.3M74](/packages/unisharp-laravel-filemanager)[league/flysystem-aws-s3-v3

AWS S3 filesystem adapter for Flysystem.

1.6k263.6M790](/packages/league-flysystem-aws-s3-v3)[spatie/laravel-google-cloud-storage

Google Cloud Storage filesystem driver for Laravel

2408.9M13](/packages/spatie-laravel-google-cloud-storage)[league/flysystem-sftp-v3

SFTP filesystem adapter for Flysystem.

6129.6M91](/packages/league-flysystem-sftp-v3)[yii2-starter-kit/yii2-file-kit

Yii2 file upload and storage kit

151216.8k6](/packages/yii2-starter-kit-yii2-file-kit)[azure-oss/storage-blob-laravel

Azure Storage Blob filesystem driver for Laravel

63582.2k1](/packages/azure-oss-storage-blob-laravel)

PHPackages © 2026

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