Movatterモバイル変換

cloudinary-community/cloudinary-laravelPublic

NotificationsYou must be signed in to change notification settings
Fork90
Star326

Laravel SDK for Cloudinary

laravel.cloudinary.dev/

License

MIT license

326 stars 90 forks Branches Tags Activity

Star

Notifications

You must be signed in to change notification settings

Branches Tags

Folders and files

Name		Name	Last commit message	Last commit date
Latest commit History 187 Commits
.github/workflows		.github/workflows
config		config
docs		docs
src		src
tests		tests
views/components		views/components
.gitignore		.gitignore
.styleci.yml		.styleci.yml
CHANGELOG.md		CHANGELOG.md
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE.md		LICENSE.md
README.md		README.md
composer.json		composer.json
composer.lock		composer.lock
phpunit.xml		phpunit.xml

Repository files navigation

A Laravel Package for uploading, optimizing, transforming and delivering media files with Cloudinary. Furthermore, it provides a fluent and expressive API to easily attach your media files to Eloquent models.

Installation

Requires PHP 8.2+ and Laravel 11+.

composer require cloudinary-labs/cloudinary-laravel

After you have installed the SDK, you can invoke the install command to set everything up:

php artisan cloudinary:install

Add your Cloudinary credentials to your.env file:

CLOUDINARY_URL=cloudinary://API_KEY:API_SECRET@CLOUD_NAMECLOUDINARY_UPLOAD_PRESET=your_upload_presetCLOUDINARY_NOTIFICATION_URL=

Note

You can get yourCLOUDINARY_URL from yourCloudinary console. It typically looks like this:cloudinary://API_KEY:API_SECRET@CLOUD_NAME. Make sure to replaceAPI_KEY,API_SECRET, andCLOUD_NAME with your actual Cloudinary credentials.

Usage

File Storage Driver

This SDK implements theFile Storage Driver interface allowing you to use it as just another storage destination like s3, azure or local disk.

Add a newcloudinary key to yourconfig/filesystems.php disk key like so:

...,'cloudinary' => ['driver' =>'cloudinary','key' =>env('CLOUDINARY_KEY'),'secret' =>env('CLOUDINARY_SECRET'),'cloud' =>env('CLOUDINARY_CLOUD_NAME'),'url' =>env('CLOUDINARY_URL'),'secure' => (bool)env('CLOUDINARY_SECURE',true),'prefix' =>env('CLOUDINARY_PREFIX'),  ],...,

Blade Components

This package provides a few Blade components for easy integration of Cloudinary media in your Laravel views.

Upload Widget

You can use the<x-cloudinary::widget /> Blade component that ships with this like so:

<!DOCTYPE html><html>  <body>    <x-cloudinary::widget>Upload Files</x-cloudinary::widget>  </body></html>

Image Component

Basic usage:

<x-cloudinary::imagepublic-id="example" />

With additional properties:

<x-cloudinary::imagepublic-id="example"width="300"height="300" />

Properties available:

Property	Required
`public-id`	Yes
`width`	No
`height`	No
`alt`	No
`class`	No
`crop`	No
`gravity`	No
`effect`	No
`rotate`	No
`colorize`	No
`trim`	No
`blur`	No
`gray-scale`	No
`black-white`	No
`sepia`	No
`redeye`	No
`negate`	No
`oil-paint`	No
`vignette`	No
`simulate-colorblind`	No
`pixelate`	No
`unsharp-mask`	No
`saturation`	No
`contrast`	No
`brightness`	No
`gamma`	No
`improve-mode`	No
`shadow`	No
`border`	No
`round-corners`	No
`bg-color`	No
`art`	No
`cartoonify`	No

Video Component

Basic usage:

<x-cloudinary::videopublic-id="example" />

With additional properties:

<x-cloudinary::videopublic-id="example"width="300"height="300" />

Properties available:

Property	Required
`public-id`	Yes
`width`	No
`height`	No

Disclaimer

This software/code provided under Cloudinary Labs is an unsupported pre-production prototype undergoing further development and provided on an “AS IS” basis without warranty of any kind, express or implied, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose are disclaimed. Furthermore, Cloudinary is not under any obligation to provide a commercial version of the software.

Your use of the Software/code is at your sole risk and Cloudinary will not be liable for any direct, indirect, incidental, special, exemplary, consequential or similar damages (including, but not limited to, procurement of substitute goods or services; loss of use, data, or profits; or business interruption) however caused and on any theory of liability, whether in contract, strict liability, or tort (including negligence or otherwise) arising in any way out of the use of the Software, even if advised of the possibility of such damage.

You should refrain from uploading any confidential or personally identifiable information to the Software. All rights to and in the Software are and will remain at all times, owned by, or licensed to Cloudinary.