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.7(3mo ago)22159.2k↓46%155MITPHPPHP >=8.0.2CI failing

Since Feb 2Pushed 3mo 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 2d ago

READMEChangelog (8)Dependencies (14)Versions (19)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

61

—

FairBetter than 98% of packages

Maintenance82

Actively maintained with recent releases

Popularity44

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

Recently: every ~368 days

Total

15

Last Release

91d 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.7k285.7M1.0k](/packages/league-flysystem-aws-s3-v3)[league/flysystem-bundle

Symfony bundle integrating Flysystem into Symfony applications

40432.5M136](/packages/league-flysystem-bundle)[barryvdh/elfinder-flysystem-driver

A Flysystem Driver for elFinder

1865.1M41](/packages/barryvdh-elfinder-flysystem-driver)[masbug/flysystem-google-drive-ext

Flysystem adapter for Google Drive with seamless virtual<=>display path translation

2682.2M18](/packages/masbug-flysystem-google-drive-ext)[league/flysystem-sftp-v3

SFTP filesystem adapter for Flysystem.

6134.8M156](/packages/league-flysystem-sftp-v3)[league/flysystem-google-cloud-storage

Google Cloud Storage adapter for Flysystem.

2319.4M70](/packages/league-flysystem-google-cloud-storage)

PHPackages © 2026

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