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

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

maxlcoder/laravel-oss
=====================

阿里云 OSS Laravel 扩展

1.1.3(2mo ago)131MITPHPPHP ^7.3|^8.0

Since Jan 14Pushed 2mo ago1 watchersCompare

[ Source](https://github.com/maxlcoder/laravel-oss)[ Packagist](https://packagist.org/packages/maxlcoder/laravel-oss)[ RSS](/packages/maxlcoder-laravel-oss/feed)WikiDiscussions main Synced today

READMEChangelog (4)Dependencies (5)Versions (8)Used By (0)

laravel-oss
===========

[](#laravel-oss)

配置
--

[](#配置)

配置文件在 `config/oss.php` 文件中，内容如下：

```
return [
    'endpoint_upload' => env('OSS_ENDPOINT_UPLOAD'),
    'endpoint' => env('OSS_ENDPOINT'),
    'access_key' => env('OSS_ACCESS_KEY'),
    'secret_key' => env('OSS_SECRET_KEY'),
    'bucket' => env('OSS_BUCKET'),
    'path' => env('OSS_PATH', ''),
    'region' => env('OSS_REGION', 'cn-hangzhou'),
    'role_arn' => env('OSS_ROLE_ARN', ''),
    'role_session_name' => env('OSS_ROLE_SESSION_NAME', ''),
];
```

**重点配置说明**

`endpoint_upload`: 表示和阿里云进行 API 交互的域名，形如 `oss-cn-hangzhou.aliyuncs.com`，例如文件上传，相关设置之类。注意这里如果是纯后端和 OSS 交互，且服务是部署在阿里云上，这里可以考虑使用内网域名

`endpoint`: 文件域名通常作为文件下载的预览的地址域名，通常使用 bucket 域名，形如 `https://[buckent-name].oss-cn-hangzhou.aliyuncs.com`，如果是不想暴露 bucket 域名也可以使用自定义域名。

域名支持情况

域名endpoint\_upload 上行（API 交互）endpoint 下行（文件下载预览）地域域名（oss-cn-hangzhou.aliyuncs.com）支持不支持bucket 域名（https://\[buckent-name\].oss-cn-hangzhou.aliyuncs.com）支持支持自定义域名（[https://xxx.xxx.com）](https://xxx.xxx.com%EF%BC%89)支持支持因此这里保留两个 endpoint 配置，便于支持各种情况

`path`: 考虑到单个 bucket 既作为开发环境，又作为生成环境，提供一个 bucket 下的顶层目录来区分不同环境下产生的文件。如果不同环境有不同的 bucket 或者不区分环境，该配置可以忽略

`role_arn`: 当设置授权角色时，支持 sts token

方法
--

[](#方法)

### 服务端上传（表单上传）

[](#服务端上传表单上传)

`$maxSize` 最大支持的上传文件大小（字节数）

```
public function signUpload($dir = '', $maxSize = 1048576000){ ... }
```

返回参数

```
return [
    'access_id' => $accessKeyId,
    'host' => $host,
    'policy' => $base64Policy,
    'signature' => $signature,
    'dir' => $dir,
];
```

### 服务端预签名上传

[](#服务端预签名上传)

`$filename` 最大支持的上传文件大小（字节数） `$acl` 权限 默认: default 私有: private 公共读: public-read 公共读写: public-read-write `$expires` 签名过期时间（默认最大支持 10 分钟）

```
public function signUrlUploadV4($fileName, $acl = 'default', $expires = 600){ ... }
```

返回参数

```
return [
    'url' => 'http://xxxx',
];
```

###  Health Score

39

—

LowBetter than 84% of packages

Maintenance87

Actively maintained with recent releases

Popularity9

Limited adoption so far

Community4

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

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

Recently: every ~109 days

Total

7

Last Release

66d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/18546126?v=4)[liurenlin](/maintainers/maxlcoder)[@maxlcoder](https://github.com/maxlcoder)

### Embed Badge

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

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

###  Alternatives

[illuminate/filesystem

The Illuminate Filesystem package.

16165.0M3.2k](/packages/illuminate-filesystem)[api-platform/laravel

API Platform support for Laravel

58170.8k14](/packages/api-platform-laravel)[tomshaw/electricgrid

A feature-rich Livewire package designed for projects that require dynamic, interactive data tables.

119.4k](/packages/tomshaw-electricgrid)

PHPackages © 2026

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