Stars: 265
Forks: 58
Pull Requests: 19
Issues: 62
Watchers: 9
Last Updated: 2021-02-04 04:54:40
Cloudinary wrapper for Laravel 5
License: MIT License
Languages: PHP
Initially forked from https://github.com/teepluss/laravel4-cloudinary.
If there is any feature you would like feel free to open an issue or send me an email!
composer require jrm2k6/cloudder
For people still using Laravel 4.2: composer require jrm2k6/cloudder:0.1.*
and check the branch l4 for the installation instructions.
Modify your .env
file to add the following information from Cloudinary
CLOUDINARY_API_KEY=012345679890123
CLOUDINARY_API_SECRET=foobarfoobarfoob-arfoobarfo
CLOUDINARY_CLOUD_NAME=foobarcorp
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(
JD\Cloudder\CloudderServiceProvider::class,
);
'aliases' => array(
'Cloudder' => JD\Cloudder\Facades\Cloudder::class,
);
Run php artisan vendor:publish --provider="JD\Cloudder\CloudderServiceProvider"
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 to know more$tags
: tags for your imagereturns the CloudinaryWrapper
.
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 imagereturns the CloudinaryWrapper
.
Cloudder::getPublicId()
returns the public id
of the last uploaded resource.
Cloudder::getResult()
returns the result of the last uploaded resource.
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 morereturns the url
of the picture on Cloudinary (https url if secureShow is used).
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 morereturns the private url
of the picture on Cloudinary, expiring by default after an hour.
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 morerenames the original picture with the $toPublicId
id parameter.
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 moreremoves image from Cloudinary.
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 moreremoves images from Cloudinary.
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 moreCloudder::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 moreCloudder::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.
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 archivereturns a download url
for the newly created archive on Cloudinary.
phpunit
You can find a working example in the repo cloudder-l5-example