PHPackages                             carlosocarvalho/flysystem-cloudinary - 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. carlosocarvalho/flysystem-cloudinary

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

carlosocarvalho/flysystem-cloudinary
====================================

Flysystem adapter for Cloudinary

v2.0.6(1y ago)22154.8k↓31.5%155MITPHPPHP >=8.0.2CI failing

Since Feb 2Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/carlosocarvalho/flysystem-cloudinary)[ Packagist](https://packagist.org/packages/carlosocarvalho/flysystem-cloudinary)[ Docs](http://carlosocarvalho.github.io/flysystem-cloudinary)[ RSS](/packages/carlosocarvalho-flysystem-cloudinary/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (8)Dependencies (7)Versions (18)Used By (5)

flysystem-cloudinary v3
=======================

[](#flysystem-cloudinary-v3)

Cloudinary adapter for The PHP League Flysystem v3

[![Codacy Badge](https://camo.githubusercontent.com/dd4723b95de36d9f033b01d1ed1b4a96307079a1208292eb86a65f7ee174268f/68747470733a2f2f6170692e636f646163792e636f6d2f70726f6a6563742f62616467652f47726164652f3430383531646365383733363433643462386334663732303639343233376461)](https://app.codacy.com/app/carlosocarvalho-git/flysystem-cloudinary?utm_source=github.com&utm_medium=referral&utm_content=carlosocarvalho/flysystem-cloudinary&utm_campaign=Badge_Grade_Dashboard)[![Author](https://camo.githubusercontent.com/b01a31172d752ec47ede8eb27d9f80f6190e2faf78617af63c3e5efa6b714e22/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6175746f722d406361726c6f736f63617276616c686f2d626c75652e7376673f7374796c653d666c61742d737175617265)](https://twitter.com/carlosocarvalho)[![Latest Stable Version](https://camo.githubusercontent.com/513bca40aa586eb5cbfa9c6b138dedba42c7afab989a6b48c804f29af82f60be/68747470733a2f2f706f7365722e707567782e6f72672f6361726c6f736f63617276616c686f2f666c7973797374656d2d636c6f7564696e6172792f76)](//packagist.org/packages/carlosocarvalho/flysystem-cloudinary) [![Total Downloads](https://camo.githubusercontent.com/b6edf4640d67ea86a94ff99e164c162c8a433bec923cced9f263b495dbf78f82/68747470733a2f2f706f7365722e707567782e6f72672f6361726c6f736f63617276616c686f2f666c7973797374656d2d636c6f7564696e6172792f646f776e6c6f616473)](https://packagist.org/packages/carlosocarvalho/flysystem-cloudinary) [![License](https://camo.githubusercontent.com/715699ad9d1de4ec9c8af05d4c313d3604a2381c7518e6b55d43a1112803a383/68747470733a2f2f706f7365722e707567782e6f72672f6361726c6f736f63617276616c686f2f666c7973797374656d2d636c6f7564696e6172792f6c6963656e7365)](https://packagist.org/packages/carlosocarvalho/flysystem-cloudinary)[![Suggesters](https://camo.githubusercontent.com/e9c27e68969d75ab5e4007b6ae42ca79bf401478684f8c79a5238465c367433a/68747470733a2f2f706f7365722e707567782e6f72672f6361726c6f736f63617276616c686f2f666c7973797374656d2d636c6f7564696e6172792f73756767657374657273)](//packagist.org/packages/carlosocarvalho/flysystem-cloudinary)[![Dependents](https://camo.githubusercontent.com/76b8c6a192283658da19170547102ada7ff11947a22356e74a0a3f0e83ffb3c9/68747470733a2f2f706f7365722e707567782e6f72672f6361726c6f736f63617276616c686f2f666c7973797374656d2d636c6f7564696e6172792f646570656e64656e7473)](//packagist.org/packages/carlosocarvalho/flysystem-cloudinary)[![composer.lock](https://camo.githubusercontent.com/ff50de1eb7a7e2d43b0b18800c07cbb2b940327e7850917197eeb65381173621/68747470733a2f2f706f7365722e707567782e6f72672f6361726c6f736f63617276616c686f2f666c7973797374656d2d636c6f7564696e6172792f636f6d706f7365726c6f636b)](//packagist.org/packages/carlosocarvalho/flysystem-cloudinary)[![Monthly Downloads](https://camo.githubusercontent.com/ba626ab51fdb5bc9f4d008d36ac3db145ba5b819baa3f06bf212cab6a312386d/68747470733a2f2f706f7365722e707567782e6f72672f6361726c6f736f63617276616c686f2f666c7973797374656d2d636c6f7564696e6172792f642f6d6f6e74686c79)](//packagist.org/packages/carlosocarvalho/flysystem-cloudinary)

Install
-------

[](#install)

```
  composer require carlosocarvalho/flysystem-cloudinary
```

Configuration
-------------

[](#configuration)

You can configure the package in two different ways.

### Using CLOUDINARY\_URL

[](#using-cloudinary_url)

You can configure the library using the environment variable `CLOUDINARY_URL`. Whe using `CLOUDINARY_URL` you have access to the underlying Cloudinary SDK without instantiating the adapter or explicit instantiating the Cloudinary SDK.

You can read more in their documentation [https://cloudinary.com/documentation/php\_integration#setting\_the\_cloudinary\_url\_environment\_variable](https://cloudinary.com/documentation/php_integration#setting_the_cloudinary_url_environment_variable)

```
use CarlosOCarvalho\Flysystem\Cloudinary\CloudinaryAdapter;
use League\Flysystem\Filesystem;

$adapter = new CloudinaryAdapter();
$filesystem = new Filesystem( $adapter );
```

### Manual configuration

[](#manual-configuration)

```
use CarlosOCarvalho\Flysystem\Cloudinary\CloudinaryAdapter;
use League\Flysystem\Filesystem;

$config = [
    'api_key' => ':key',
    'api_secret' => ':secret',
    'cloud_name' => ':name',
];

$adapter = new CloudinaryAdapter($config);
$filesystem = new Filesystem( $adapter );
```

Example
-------

[](#example)

### List contents and others actions use Filesystem api

[](#list-contents-and-others-actions-use-filesystem-api)

```
#Options use file type resource

$filesystem->listContents()
```

### Add Resource Type list in container `image`,`video`, `raw`

[](#add-resource-type-list-in-container-imagevideo-raw)

```
CloudinaryAdapter::$resourceType = \Cloudinary\Asset\AssetType::IMAGE;
$filesystem->listContents()
```

### Add content list type in container 'upload', 'private', 'authenticated', 'fetch', 'facebook', 'twitter', 'gravatar', 'youtube', 'hulu', 'vimeo', 'animoto', 'worldstarhiphop', 'dailymotion', 'list'

[](#add-content-list-type-in-container-upload-private-authenticated-fetch-facebook-twitter-gravatar-youtube-hulu-vimeo-animoto-worldstarhiphop-dailymotion-list)

```
CloudinaryAdapter::$listContentsType = \Cloudinary\Asset\DeliveryType::UPLOAD;
$filesystem->listContents()
```

### For use in laravel

[](#for-use-in-laravel)

To use in Laravel register you must register the driver. Learn [how to register a custom filesystem](https://github.com/carlosocarvalho/laravel-storage-cloudinary) in the Laravel Documentation.

```
    use Illuminate\Filesystem\FilesystemAdapter;
    use Illuminate\Support\Facades\Storage;
    use League\Flysystem\Filesystem;
    use CarlosOCarvalho\Flysystem\Cloudinary\CloudinaryAdapter;

    ...

    Storage::extend('cloudinary', function ($app, $config) {
        if(!empty(env('CLOUDINARY_URL'))){
            $adapter = new CloudinaryAdapter();
        }else{
            $adapter = new CloudinaryAdapter($config);
        }

        return new FilesystemAdapter(
            new Filesystem($adapter, $config),
            $adapter,
            $config
        );
    });
```

[ Access this repository ](https://github.com/carlosocarvalho/laravel-storage-cloudinary)

###  Health Score

57

—

FairBetter than 98% of packages

Maintenance70

Regular maintenance activity

Popularity43

Moderate usage in the ecosystem

Community25

Small or concentrated contributor base

Maturity77

Established project with proven stability

 Bus Factor1

Top contributor holds 56% 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 ~256 days

Recently: every ~338 days

Total

14

Last Release

428d ago

Major Versions

1.1.1 → 2.0.0-alpha2020-04-02

PHP version history (4 changes)1.0.0PHP >=5.4.0

1.1.1PHP >=5.6.0

2.0.0-alphaPHP >=7.2

v2.0.3PHP >=8.0.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/5dc2e34302265b87bcbef211ffb061b589b7e56f699b9972abca7f5691e524d5?d=identicon)[carlosocarvalho](/maintainers/carlosocarvalho)

---

Top Contributors

[![carlosocarvalho](https://avatars.githubusercontent.com/u/1370878?v=4)](https://github.com/carlosocarvalho "carlosocarvalho (42 commits)")[![carnevalle](https://avatars.githubusercontent.com/u/54747?v=4)](https://github.com/carnevalle "carnevalle (21 commits)")[![mathielen](https://avatars.githubusercontent.com/u/1571485?v=4)](https://github.com/mathielen "mathielen (3 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (3 commits)")[![rainerkent](https://avatars.githubusercontent.com/u/17761544?v=4)](https://github.com/rainerkent "rainerkent (3 commits)")[![warksit](https://avatars.githubusercontent.com/u/5296633?v=4)](https://github.com/warksit "warksit (1 commits)")[![rogervila](https://avatars.githubusercontent.com/u/6053012?v=4)](https://github.com/rogervila "rogervila (1 commits)")[![codacy-badger](https://avatars.githubusercontent.com/u/23704769?v=4)](https://github.com/codacy-badger "codacy-badger (1 commits)")

---

Tags

flysystemflysystem-adapterflysystem-cloudinarytheleague-php-flysystemFlysystemcloudinary

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/carlosocarvalho-flysystem-cloudinary/health.svg)

```
[![Health](https://phpackages.com/badges/carlosocarvalho-flysystem-cloudinary/health.svg)](https://phpackages.com/packages/carlosocarvalho-flysystem-cloudinary)
```

###  Alternatives

[league/flysystem-aws-s3-v3

AWS S3 filesystem adapter for Flysystem.

1.6k263.6M790](/packages/league-flysystem-aws-s3-v3)[league/flysystem-local

Local filesystem adapter for Flysystem.

226231.8M39](/packages/league-flysystem-local)[oneup/flysystem-bundle

Integrates Flysystem filesystem abstraction library to your Symfony project.

64422.9M66](/packages/oneup-flysystem-bundle)[league/flysystem-bundle

Symfony bundle integrating Flysystem into Symfony applications

40029.5M87](/packages/league-flysystem-bundle)[league/flysystem-sftp-v3

SFTP filesystem adapter for Flysystem.

6129.6M91](/packages/league-flysystem-sftp-v3)[spatie/flysystem-dropbox

Flysystem Adapter for the Dropbox v2 API

3644.6M68](/packages/spatie-flysystem-dropbox)

PHPackages © 2026

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