PHPackages                             bakerkretzmar/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. [API Development](/categories/api)
4. /
5. bakerkretzmar/laravel-cloudinary

AbandonedArchivedLibrary[API Development](/categories/api)

bakerkretzmar/laravel-cloudinary
================================

Cloudinary API wrapper for Laravel

065PHP

Since Aug 20Pushed 6y agoCompare

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

READMEChangelogDependenciesVersions (1)Used By (0)

Laravel Cloudinary
==================

[](#laravel-cloudinary)

[![Build Status](https://camo.githubusercontent.com/f74cd89c57e7baccaede9d8c31ed347370ec1f9257b0245a7be4966c68496ebc/68747470733a2f2f7472617669732d63692e6f72672f62616b65726b7265747a6d61722f6c61726176656c2d636c6f7564696e6172792e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/bakerkretzmar/laravel-cloudinary)[![StyleCI](https://camo.githubusercontent.com/531e22c31968322320ba3188c6fd31d889e213ff7c57bcfcc7b7c3c1f475de8a/68747470733a2f2f6769746875622e7374796c6563692e696f2f7265706f732f3230313133323735322f736869656c643f6272616e63683d6d6173746572267374796c653d666c6174)](https://github.styleci.io/repos/201132752)

[![Latest stable version](https://camo.githubusercontent.com/8c93f466b678bdc792148b970d7a4d78ac94cd2ec1075f641fed658f7878a7c9/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f62616b65726b7265747a6d61722f6c61726176656c2d636c6f7564696e6172792e7376673f7374796c653d666c6174)](https://packagist.org/packages/bakerkretzmar/laravel-cloudinary)[![Total downloads](https://camo.githubusercontent.com/fb2244eee3f2e21188032a9770f995feb07a2112e6aa29f2d71fa3061627687c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f62616b65726b7265747a6d61722f6c61726176656c2d636c6f7564696e6172792e7376673f7374796c653d666c6174)](https://packagist.org/packages/bakerkretzmar/laravel-cloudinary)[![MIT license](https://camo.githubusercontent.com/e84fd6eaac0f8a4ad632f9a4c6312011a0469294aff2a72affb6b96f9f381097/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f62616b65726b7265747a6d61722f6c61726176656c2d636c6f7564696e6172792e7376673f7374796c653d666c6174)](https://github.com/bakerkretzmar/laravel-cloudinary/blob/master/LICENSE)

[Cloudinary](https://cloudinary.com/) API wrapper for Laravel.

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

[](#installation)

```
composer require bakerkretzmar/laravel-mapbox
```

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

[](#configuration)

Add the following to your `.env` file:

```
# Required
CLOUDINARY_CLOUD_NAME={your Cloudinary cloud name}
CLOUDINARY_API_KEY={your Cloudinary API key}
CLOUDINARY_API_SECRET={your Cloudinary API secret}

# Optional
CLOUDINARY_BASE_URL={custom base asset URL}
CLOUDINARY_SECURE_URL={secure custom base asset URL}
```

Optionally, you can publish the package’s config file:

```
php artisan vendor:publish --provider="Bakerkretzmar\LaravelCloudinary\LaravelCloudinaryServiceProvider"
```

Usage
-----

[](#usage)

### upload()

[](#upload)

```
Cloudder::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)

```
Cloudder::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)

```
Cloudder::getPublicId()
```

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

### getResult()

[](#getresult)

```
Cloudder::getResult()
```

returns the result of the last uploaded resource.

### show() + secureShow()

[](#show--secureshow)

```
Cloudder::show($publicId, array $options)
Cloudder::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)

```
Cloudder::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)

```
Cloudder::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)

```
Cloudder::destroyImage($publicId, array $options)
Cloudder::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)

```
Cloudder::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)

```
Cloudder::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)

```
Cloudder::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)

```
Cloudder::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)

```
Cloudder::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.

Running tests
-------------

[](#running-tests)

`phpunit`

Example
-------

[](#example)

You can find a working example in the repo [cloudder-l5-example](https://github.com/jrm2k6/cloudder-l5-sample-project)

Credits
-------

[](#credits)

Based on Jeremy Dagorn’s [`cloudder`](https://github.com/jrm2k6/cloudder).

###  Health Score

20

—

LowBetter than 14% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity36

Early-stage or recently created project

 Bus Factor1

Top contributor holds 68.3% 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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/49a7ea27b2815fb208a46e27bf867eb802bc951bb257ee5fa1097eaaf651d34e?d=identicon)[bakerkretzmar](/maintainers/bakerkretzmar)

---

Top Contributors

[![jrm2k6](https://avatars.githubusercontent.com/u/1088099?v=4)](https://github.com/jrm2k6 "jrm2k6 (56 commits)")[![bakerkretzmar](https://avatars.githubusercontent.com/u/18192441?v=4)](https://github.com/bakerkretzmar "bakerkretzmar (13 commits)")[![rogervila](https://avatars.githubusercontent.com/u/6053012?v=4)](https://github.com/rogervila "rogervila (5 commits)")[![bjohanning](https://avatars.githubusercontent.com/u/38767939?v=4)](https://github.com/bjohanning "bjohanning (2 commits)")[![clemblanco](https://avatars.githubusercontent.com/u/668419?v=4)](https://github.com/clemblanco "clemblanco (2 commits)")[![osbre](https://avatars.githubusercontent.com/u/23292709?v=4)](https://github.com/osbre "osbre (1 commits)")[![markeilander](https://avatars.githubusercontent.com/u/2378970?v=4)](https://github.com/markeilander "markeilander (1 commits)")[![joseraul](https://avatars.githubusercontent.com/u/676681?v=4)](https://github.com/joseraul "joseraul (1 commits)")[![mikeaag](https://avatars.githubusercontent.com/u/1278785?v=4)](https://github.com/mikeaag "mikeaag (1 commits)")

---

Tags

apicloudinarycloudinary-apiimageimage-processinglaravellaravel-package

### Embed Badge

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

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

###  Alternatives

[stripe/stripe-php

Stripe PHP Library

4.0k143.3M480](/packages/stripe-stripe-php)[twilio/sdk

A PHP wrapper for Twilio's API

1.6k92.9M271](/packages/twilio-sdk)[knplabs/github-api

GitHub API v3 client

2.2k15.8M187](/packages/knplabs-github-api)[facebook/php-business-sdk

PHP SDK for Facebook Business

90121.9M34](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php

PHP wrapper for the Meilisearch API

73813.7M114](/packages/meilisearch-meilisearch-php)[google/gax

Google API Core for PHP

263103.1M454](/packages/google-gax)

PHPackages © 2026

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