jrm2k6 / cloudder
Cloudinary API wrapper for Laravel
Installs: 749 579
Dependents: 5
Suggesters: 0
Security: 0
Stars: 269
Watchers: 9
Forks: 52
Open Issues: 5
Requires
- php: >=5.3.0
- cloudinary/cloudinary_php: ^1.1
Requires (Dev)
- laravel/framework: >=5.0
- mockery/mockery: 0.9.*
- phpunit/phpunit: 4.*
README
This project is not actively maintained. I might be slow to answer, as you can tell by looking at the issues. I have moved to some new projects, not in the PHP ecosystem. You can always reach out to me through my email.
If you fork it on publish it as your own, it might be nice to credit the original author at https://github.com/teepluss/laravel4-cloudinary.
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!
Installation
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.
Configuration
Modify your .env
file to add the following information from Cloudinary
Required
CLOUDINARY_API_KEY=012345679890123
CLOUDINARY_API_SECRET=foobarfoobarfoob-arfoobarfo
CLOUDINARY_CLOUD_NAME=foobarcorp
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( JD\Cloudder\CloudderServiceProvider::class, ); 'aliases' => array( 'Cloudder' => JD\Cloudder\Facades\Cloudder::class, );
Run php artisan vendor:publish --provider="JD\Cloudder\CloudderServiceProvider"
Usage
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 to know more$tags
: tags for your image
returns the CloudinaryWrapper
.
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()
Cloudder::getPublicId()
returns the public id
of the last uploaded resource.
getResult()
Cloudder::getResult()
returns the result of the last uploaded resource.
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()
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()
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()
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()
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()
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()
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()
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()
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
phpunit
Example
You can find a working example in the repo cloudder-l5-example