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

ActiveLibrary

shanmuga/laravel-cloudinary
===========================

Cloudinary Wrapper for Laravel 5,6 and 7

v1.1(4y ago)0935MITPHPPHP &gt;=5.6.0CI failing

Since Jul 8Pushed 3y ago1 watchersCompare

[ Source](https://github.com/shanmuga3/laravel-cloudinary)[ Packagist](https://packagist.org/packages/shanmuga/laravel-cloudinary)[ RSS](/packages/shanmuga-laravel-cloudinary/feed)WikiDiscussions master Synced yesterday

READMEChangelog (2)Dependencies (2)Versions (3)Used By (0)

Cloudinary API Wrapper for Laravel 5,6 and 7.
=============================================

[](#cloudinary-api-wrapper-for-laravel-56-and-7)

[![Latest Version on Packagist](https://camo.githubusercontent.com/5e1b6ef36ce5dd62ed1ee3b25fa75161d56efe9f8576297e1dd925d19625c573/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7368616e6d7567612f636c6f7564696e6172792e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/shanmuga/laravel-cloudinary)[![Build Status](https://camo.githubusercontent.com/bd5a9fc670579c1c0ed722742eea29e8bcb52e4c519f598b8b768130c3315a14/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f7368616e6d7567612f636c6f7564696e6172792f6d61737465722e7376673f7374796c653d666c61742d737175617265)](https://travis-ci.org/shanmuga/laravel-cloudinary)[![Quality Score](https://camo.githubusercontent.com/206c7c2fd05f637c80bced7294dee0fdcc8714af85e7e8c2ea8d3019c3f502ac/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f7368616e6d7567612f636c6f7564696e6172792e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/shanmuga/laravel-cloudinary)[![Total Downloads](https://camo.githubusercontent.com/1d6217f7431cbc66bc42577816876e0fabbe615bfffed9c1f23ff8a8362f56db/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7368616e6d7567612f636c6f7564696e6172792e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/shanmuga/laravel-cloudinary)

This is where your description should go. Try and limit it to a paragraph or two, and maybe throw in a mention of what PSRs you support to avoid any confusion with users and contributors.

> *This Package is the fork of unmaintained package *

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

[](#installation)

You can install the package via composer:

```
composer require shanmuga/laravel-cloudinary
```

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

[](#configuration)

Modify your `.env` file to add the following information from [Cloudinary](http://www.cloudinary.com)

### Required

[](#required)

```
CLOUDINARY_API_KEY=your_api_key
CLOUDINARY_API_SECRET=your_api_secret_key
CLOUDINARY_CLOUD_NAME=your_cloud_name

```

### Optional

[](#optional)

```
CLOUDINARY_BASE_URL
CLOUDINARY_SECURE_URL
CLOUDINARY_API_BASE_URL

```

Laravel 5.5+ uses Package Auto-Discovery, so doesn't require you to manually add the ServiceProvider. If you don't use auto-discovery follow the next steps:

Add the following in config/app.php:

```
'providers' => array(
  Shanmuga\LaravelCloudinary\CloudinaryServiceProvider::class,
);

'aliases' => array(
  'LaravelCloudinary' => Shanmuga\LaravelCloudinary\Facades\CloudinaryFacade::class,
);
```

Run `php artisan vendor:publish --tag="LaravelCloudinary"`

### Usage

[](#usage)

upload()
--------

[](#upload)

```
LaravelCloudinary::upload($filename, $publicId, array $options, array $tags);
```

with:

- `$filename`: path to the image you want to upload
- `$publicId`: the id you want your picture to have on Cloudinary, leave it null to have Cloudinary generate a random id.
- `$options`: options for your uploaded image, check the [Cloudinary documentation](http://cloudinary.com/documentation/php_image_upload#all_upload_options) to know more
- `$tags`: tags for your image

returns the `CloudinaryWrapper`.

uploadVideo()
-------------

[](#uploadvideo)

```
LaravelCloudinary::uploadVideo($filename, $publicId, array $options, array $tags);
```

with:

- `$filename`: path to the video you want to upload
- `$publicId`: the id you want your video to have on Cloudinary, leave it null to have Cloudinary generate a random id.
- `$options`: options for your uploaded video, check the Cloudinary documentation to know more
- `$tags`: tags for your image

returns the `CloudinaryWrapper`.

getPublicId()
-------------

[](#getpublicid)

```
LaravelCloudinary::getPublicId()
```

returns the `public id` of the last uploaded resource.

getResult()
-----------

[](#getresult)

```
LaravelCloudinary::getResult()
```

returns the result of the last uploaded resource.

show() + secureShow()
---------------------

[](#show--secureshow)

```
LaravelCloudinary::show($publicId, array $options)
LaravelCloudinary::secureShow($publicId, array $options)
```

with:

- `$publicId`: public id of the resource to display
- `$options`: options for your uploaded resource, check the Cloudinary documentation to know more

returns the `url` of the picture on Cloudinary (https url if secureShow is used).

showPrivateUrl()
----------------

[](#showprivateurl)

```
LaravelCloudinary::showPrivateUrl($publicId, $format, array $options)
```

with:

- `$publicId`: public id of the resource to display
- `$format`: format of the resource your want to display ('png', 'jpg'...)
- `$options`: options for your uploaded resource, check the Cloudinary documentation to know more

returns the `private url` of the picture on Cloudinary, expiring by default after an hour.

rename()
--------

[](#rename)

```
LaravelCloudinary::rename($publicId, $toPublicId, array $options)
```

with:

- `$publicId`: publicId of the resource to rename
- `$toPublicId`: new public id of the resource
- `$options`: options for your uploaded resource, check the cloudinary documentation to know more

renames the original picture with the `$toPublicId` id parameter.

destroyImage() + delete()
-------------------------

[](#destroyimage--delete)

```
LaravelCloudinary::destroyImage($publicId, array $options)
LaravelCloudinary::delete($publicId, array $options)
```

with:

- `$publicId`: publicId of the resource to remove
- `$options`: options for the image to delete, check the cloudinary documentation to know more

removes image from Cloudinary.

destroyImages()
---------------

[](#destroyimages)

```
LaravelCloudinary::destroyImages(array $publicIds, array $options)
```

with:

- `$publicIds`: array of ids, identifying the pictures to remove
- `$options`: options for the images to delete, check the cloudinary documentation to know more

removes images from Cloudinary.

addTag()
--------

[](#addtag)

```
LaravelCloudinary::addTag($tag, $publicIds, array $options)
```

with:

- `$tag`: tag to apply
- `$publicIds`: images to apply tag to
- `$options`: options for your uploaded resource, check the cloudinary documentation to know more

removeTag()
-----------

[](#removetag)

```
LaravelCloudinary::removeTag($tag, $publicIds, array $options)
```

with:

- `$tag`: tag to remove
- `$publicIds`: images to remove tag from
- `$options`: options for your uploaded image, check the Cloudinary documentation to know more

createArchive()
---------------

[](#createarchive)

```
LaravelCloudinary::createArchive(array $options, $archiveName, $mode)
```

with:

- `$options`: options for your archive, like name, tag/prefix/public ids to select images
- `$archiveName`: name you want to give to your archive
- `$mode`: 'create' or 'download' ('create' will create an archive and returns a JSON response with the properties of the archive, 'download' will return the zip file for download)

creates a zip file on Cloudinary.

downloadArchiveUrl()
--------------------

[](#downloadarchiveurl)

```
LaravelCloudinary::downloadArchiveUrl(array $options, $archiveName)
```

with:

- `$options`: options for your archive, like name, tag/prefix/public ids to select images
- `$archiveName`: name you want to give to your archive

returns a `download url` for the newly created archive on Cloudinary.

### Changelog

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

### Security

[](#security)

If you discover any security related issues, please email  instead of using the issue tracker.

Credits
-------

[](#credits)

- [Shanmuga](https://github.com/shanmuga3)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity14

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity51

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

Total

2

Last Release

1540d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/03489b470d060269bc42526866a270194d3e8180f58330c0216172c0488e64d3?d=identicon)[shanmuga3](/maintainers/shanmuga3)

---

Top Contributors

[![shanmuga3](https://avatars.githubusercontent.com/u/38732797?v=4)](https://github.com/shanmuga3 "shanmuga3 (11 commits)")

---

Tags

phplaravelcloudinarylaravel-cloudinaryshanmuga

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/shanmuga-laravel-cloudinary/health.svg)

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

###  Alternatives

[cloudinary-labs/cloudinary-laravel

A Laravel Cloudinary Package

3311.2M5](/packages/cloudinary-labs-cloudinary-laravel)[codebar-ag/laravel-flysystem-cloudinary

Cloudinary Flysystem v1 integration with Laravel

1224.9k2](/packages/codebar-ag-laravel-flysystem-cloudinary)[yoelpc4/laravel-cloudinary

Laravel Cloudinary filesystem cloud driver.

3343.0k](/packages/yoelpc4-laravel-cloudinary)[teepluss/cloudinary

Cloudinary API wrapper for Laravel 4

1810.5k](/packages/teepluss-cloudinary)

PHPackages © 2026

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