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

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

mdhesari/laravel-flysystem-cloudinary
=====================================

Cloudinary Flysystem v1 integration with Laravel

1.0.3(4y ago)010MITPHPPHP ^8.0

Since May 24Pushed 4y agoCompare

[ Source](https://github.com/Mdhesari/laravel-flysystem-cloudinary)[ Packagist](https://packagist.org/packages/mdhesari/laravel-flysystem-cloudinary)[ Docs](https://github.com/codebar-ag/laravel-flysystem-cloudinary)[ RSS](/packages/mdhesari-laravel-flysystem-cloudinary/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (11)Versions (9)Used By (0)

[![](https://camo.githubusercontent.com/3f6cd1b7d34968a6bd5f5334d201321c6c7023d86e8f2cccaba0a213d059f963/68747470733a2f2f62616e6e6572732e6265796f6e64636f2e64652f4c61726176656c253230466c7973797374656d253230436c6f7564696e6172792e706e673f7468656d653d6c69676874267061636b6167654d616e616765723d636f6d706f7365722b72657175697265267061636b6167654e616d653d636f64656261722d61672532466c61726176656c2d666c7973797374656d2d636c6f7564696e617279267061747465726e3d63697263756974426f617264267374796c653d7374796c655f32266465736372697074696f6e3d416e2b6f70696e696f6e617465642b7761792b746f2b696e746567726174652b436c6f7564696e6172792b776974682b7468652b4c61726176656c2b66696c6573797374656d266d643d312673686f7757617465726d61726b3d3026666f6e7453697a653d313530707826696d616765733d636c6f7564267769647468733d35303026686569676874733d353030)](https://camo.githubusercontent.com/3f6cd1b7d34968a6bd5f5334d201321c6c7023d86e8f2cccaba0a213d059f963/68747470733a2f2f62616e6e6572732e6265796f6e64636f2e64652f4c61726176656c253230466c7973797374656d253230436c6f7564696e6172792e706e673f7468656d653d6c69676874267061636b6167654d616e616765723d636f6d706f7365722b72657175697265267061636b6167654e616d653d636f64656261722d61672532466c61726176656c2d666c7973797374656d2d636c6f7564696e617279267061747465726e3d63697263756974426f617264267374796c653d7374796c655f32266465736372697074696f6e3d416e2b6f70696e696f6e617465642b7761792b746f2b696e746567726174652b436c6f7564696e6172792b776974682b7468652b4c61726176656c2b66696c6573797374656d266d643d312673686f7757617465726d61726b3d3026666f6e7453697a653d313530707826696d616765733d636c6f7564267769647468733d35303026686569676874733d353030)

[![Latest Version on Packagist](https://camo.githubusercontent.com/6b4cbfb45d535d5531f13819e2632c5af591713aaf7ac526256b302e376507b9/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f636f64656261722d61672f6c61726176656c2d666c7973797374656d2d636c6f7564696e6172792e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/codebar-ag/laravel-flysystem-cloudinary)[![Total Downloads](https://camo.githubusercontent.com/87d4c05a60370fccd1172e5e136fc07fd32456c8eb07e8446f010b0a6cb09409/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f636f64656261722d61672f6c61726176656c2d666c7973797374656d2d636c6f7564696e6172792e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/codebar-ag/laravel-flysystem-cloudinary)[![run-tests](https://github.com/codebar-ag/laravel-flysystem-cloudinary/actions/workflows/run-tests.yml/badge.svg)](https://github.com/codebar-ag/laravel-flysystem-cloudinary/actions/workflows/run-tests.yml)[![Check & fix styling](https://github.com/codebar-ag/laravel-flysystem-cloudinary/actions/workflows/php-cs-fixer.yml/badge.svg)](https://github.com/codebar-ag/laravel-flysystem-cloudinary/actions/workflows/php-cs-fixer.yml)

💡 What is Cloudinary?
---------------------

[](#-what-is-cloudinary)

Cloudinary is basically a fantastic way to store and serve assets like images or videos. You can upload your full resolution image to Cloudinary, and they handle the optimization for you. The only thing you have to do is to add additional parameters to your url 😉

🛠 Requirements
--------------

[](#-requirements)

- PHP: `^8.0`
- Laravel: `^8.12`
- league/flysystem: `^1.1` (default in Laravel 8)
- Cloudinary Account

⚙️ Installation
---------------

[](#️-installation)

You can install the package via composer:

```
composer require codebar-ag/laravel-flysystem-cloudinary
```

Add the following disk to your filesystem "disks" list in your `filesystems.php`configuration:

```
    'disks' => [
        //

        'cloudinary' => [
            'driver' => 'cloudinary',
            'cloud_name' => env('CLOUDINARY_CLOUD_NAME'),
            'api_key' => env('CLOUDINARY_API_KEY'),
            'api_secret' => env('CLOUDINARY_API_SECRET'),
            'url' => [
                'secure' => (bool) env('CLOUDINARY_SECURE_URL', true),
            ],
        ],

    ],
```

Add the following environment variables to your `.env` file:

```
FILESYSTEM_DRIVER=cloudinary

CLOUDINARY_CLOUD_NAME=my-cloud-name
CLOUDINARY_API_KEY=my-api-key
CLOUDINARY_API_SECRET=my-api-secret
```

🏗 File extension problem
------------------------

[](#-file-extension-problem)

Let's look at the following example:

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

Storage::disk('cloudinary')->put('cat.jpg', $contents);
```

This will generate following URL with double extensions:

```
https://res.cloudinary.com/my-cloud-name/image/upload/v1/cat.jpg.jpg

```

To prevent this you should store your images without the file extension:

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

Storage::disk('cloudinary')->put('cat', $contents);
```

This is now much better:

```
https://res.cloudinary.com/my-cloud-name/image/upload/v1/cat.jpg

```

### 🪐 How to use with Nova

[](#-how-to-use-with-nova)

To customize the name of the stored file, you may use the `storeAs` methods of the `Image` field:

```
use Illuminate\Http\Request;
use Laravel\Nova\Fields\Image;

Image::make('Image')
    ->disk('cloudinary')
    ->storeAs(function (Request $request) {
        return sha1($request->image->getClientOriginalName());
    }),
```

🗂 How to use folder prefix
--------------------------

[](#-how-to-use-folder-prefix)

Imagine the following example. We have different clients but want to store the assets in the same Cloudinary account. Normally we have to prefix every path with the correct client folder name. Fortunately, the package helps us here. We can configure a folder in our environment file like this:

```
CLOUDINARY_FOLDER=client_cat
```

Now all our assets will be prefixed with the `client_cat/` folder. When we store following image:

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

Storage::disk('cloudinary')->put('meow', $contents);
```

It will produce following URL:

```
https://res.cloudinary.com/my-cloud-name/image/upload/v1/client_cat/meow.jpg

```

In the Media Library it is stored in `client_cat/meow` and you can retrieve the image with `meow`:

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

Storage::disk('cloudinary')->getUrl('meow');

```

This should increase the trust to store and retrieve your assets from the correct folder.

🔋 Rate limit gotchas
--------------------

[](#-rate-limit-gotchas)

All files in Cloudinary are stored with a resource type. There are three kinds of it: `image`, `raw` and `video`. For example if we want to check if a video exists, we need to make up to 3 requests. Every type needs to be checked on their own with a separate request.

Keep this in mind because the admin API is rate limited to 500 calls per hour.

The package does check in following sequence:

- `image` ➡️ `raw` ➡️ `video`

🔧 Configuration file
--------------------

[](#-configuration-file)

You can publish the config file with:

```
php artisan vendor:publish --tag="flysystem-cloudinary-config"
```

This is the contents of the published config file:

```