PHPackages                             ripples/aliyun-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. ripples/aliyun-oss

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

ripples/aliyun-oss
==================

Wrap for Aliyun OSS SDK and make it more easy to use.

0.1.3(10y ago)230MITPHP

Since Sep 2Pushed 10y ago2 watchersCompare

[ Source](https://github.com/ripples-alive/Aliyun-OSS)[ Packagist](https://packagist.org/packages/ripples/aliyun-oss)[ Docs](https://github.com/JayvicWen/Aliyun-OSS)[ RSS](/packages/ripples-aliyun-oss/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (5)Used By (0)

Aliyun OSS
==========

[](#aliyun-oss)

This is wrapper for Aliyun OSS SDK and make it more easy to use.

Supporting internal and external endpoints for better operations.

Installation
------------

[](#installation)

This package can be installed through `composer`.

```
composer require ripples/aliyun-oss
```

Usage
-----

[](#usage)

See [examples/example.php](examples/example.php)

Your can give both external and internal endpoints when constructing. The last parameter of each method represent whether to use the internal endpoint or the other one.

By default, we used the internal endpoint except the methods to generate signatured url.

We use the value of external endpoint as the default value of internal endpoint. So if you don't want to use two endpoints, just omit the internal endpoint when constructing. Then, no matter what parameter you use when call the methods, we will all use the external endpoint.

> If you want to update meta data when copy file, remember to set `x-oss-metadata-directive` header to `REPLACE`.
>
> Be cautious when update meta data. Assume that the init headers are `['a' => 1, 'b' => 2]`.
>
> After `modifyMeta('bucket', 'key', ['b' => 3])`, the headers would be `['a' => 1, 'b' => 3]`.
>
> After `setMeta('bucket', 'key', ['b' => 3])`, the headers would be `['b' => 3]`.

Notice that we'll automatic check the response status. And you can modify the attribute `ok_status` to intervene it.

##### Finally, we define the clients as public. So it's ok to call the method of Aliyun SDK directly.

[](#finally-we-define-the-clients-as-public-so-its-ok-to-call-the-method-of-aliyun-sdk-directly)

LICENSE
-------

[](#license)

[MIT](./LICENSE)

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity56

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

Every ~11 days

Total

4

Last Release

3876d ago

### Community

Maintainers

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

---

Top Contributors

[![ripples-alive](https://avatars.githubusercontent.com/u/7439574?v=4)](https://github.com/ripples-alive "ripples-alive (9 commits)")

---

Tags

aliyunoss

### Embed Badge

![Health badge](/badges/ripples-aliyun-oss/health.svg)

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

###  Alternatives

[jacobcyl/ali-oss-storage

aliyun oss filesystem storage for laravel 5+

523566.2k7](/packages/jacobcyl-ali-oss-storage)[johnlui/aliyun-oss

阿里云 OSS 官方 SDK 的 Composer 封装，支持任何 PHP 项目，包括 Laravel、Symfony、TinyLara 等等。

501178.3k6](/packages/johnlui-aliyun-oss)[alphasnow/aliyun-oss-laravel

alibaba cloud object storage service for laravel

182240.7k2](/packages/alphasnow-aliyun-oss-laravel)[alphasnow/aliyun-oss-flysystem

Flysystem adapter for the Aliyun storage

14249.2k4](/packages/alphasnow-aliyun-oss-flysystem)[summergeorge/ali-oss-storage

aliyun oss filesystem storage for laravel 5+

3915.5k](/packages/summergeorge-ali-oss-storage)[johnlui/aliyun-oss-laravel7

阿里云 OSS 官方 SDK 的 Composer 封装，支持任何 PHP 项目，包括 Laravel、Symfony、TinyLara 等等。

347.8k1](/packages/johnlui-aliyun-oss-laravel7)

PHPackages © 2026

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