PHPackages yoelpc4/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. [File & Storage](/categories/file-storage) 4. / 5. yoelpc4/laravel-cloudinary ActiveLibrary[File & Storage](/categories/file-storage) yoelpc4/laravel-cloudinary ========================== Laravel Cloudinary filesystem cloud driver. v6.0.0(1y ago)3345.6k↓65.3%11[1 PRs](https://github.com/yoelpc4/laravel-cloudinary/pulls)MITPHPPHP >=8.2CI failing Since Apr 19Pushed 1y ago3 watchersCompare [ Source](https://github.com/yoelpc4/laravel-cloudinary)[ Packagist](https://packagist.org/packages/yoelpc4/laravel-cloudinary)[ Docs](https://github.com/yoelpc4/laravel-cloudinary)[ RSS](/packages/yoelpc4-laravel-cloudinary/feed)WikiDiscussions master Synced 2d ago READMEChangelog (5)Dependencies (8)Versions (12)Used By (0) Laravel Cloudinary ================== [](#laravel-cloudinary) [![Packagist](https://camo.githubusercontent.com/e0fa67400331cb7c81927f58158a92e78b42f2941858fb8c621588fc408614f8/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f796f656c7063342f6c61726176656c2d636c6f7564696e6172792e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/yoelpc4/laravel-cloudinary)[![Downloads](https://camo.githubusercontent.com/ab9a65260b6622cdc841bdb18045d682259e89c0df20653776a3fee649cf9e72/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f796f656c7063342f6c61726176656c2d636c6f7564696e6172792e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/yoelpc4/laravel-cloudinary)[![Tests](https://github.com/yoelpc4/laravel-cloudinary/actions/workflows/tests.yml/badge.svg?style=flat-square)](https://github.com/yoelpc4/laravel-cloudinary/actions/workflows/tests.yml)[![Code Coverage](https://camo.githubusercontent.com/8fade59d765edb73a51597c4390141165a7836efdbfb5e5e64f2d5262f193cb3/68747470733a2f2f636f6465636f762e696f2f67682f796f656c7063342f6c61726176656c2d636c6f7564696e6172792f6272616e63682f6d61737465722f67726170682f62616467652e7376673f7374796c653d666c61742d737175617265)](https://codecov.io/gh/yoelpc4/laravel-cloudinary)[![Software License](https://camo.githubusercontent.com/a182fa35c8e9cd5ead39595e4cc428164e1bc391e56a5207e7fe3ec595ecd2f5/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f796f656c7063342f6c61726176656c2d636c6f7564696e6172792e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)[![Contributor Covenant](https://camo.githubusercontent.com/2757a9db291c5ceda172e31d4fa5f3c4048a6e6257ee0b7113f80de277074b91/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f436f6e7472696275746f72253230436f76656e616e742d76322e3025323061646f707465642d6666363962342e737667)](CODE_OF_CONDUCT.md) *Laravel Cloudinary filesystem driver.* Requirement ----------- [](#requirement) - [Laravel](https://laravel.com) - [Cloudinary Account Details](https://cloudinary.com) Laravel Version Compatibilities ------------------------------- [](#laravel-version-compatibilities) LaravelPackage12.x.x6.x11.x.x5.x10.x.x4.x9.x.x3.x8.x.x2.x7.x.x2.x6.x.x2.xInstall ------- [](#install) Requires this package with composer via command: ``` composer require yoelpc4/laravel-cloudinary ``` Environment Variable -------------------- [](#environment-variable) Register your Cloudinary account details [here](https://cloudinary.com/console). Then add these lines to your .env. ``` FILESYSTEM_DISK=cloudinary CLOUDINARY_API_KEY= CLOUDINARY_API_SECRET= CLOUDINARY_CLOUD_NAME= CLOUDINARY_SECURE=true ``` Filesystem Configuration ------------------------ [](#filesystem-configuration) Register cloudinary driver configuration in `config/filesystems.php` at disks section as follows ``` 'cloudinary' => [ 'driver' => 'cloudinary', 'api_key' => env('CLOUDINARY_API_KEY'), 'api_secret' => env('CLOUDINARY_API_SECRET'), 'cloud_name' => env('CLOUDINARY_CLOUD_NAME'), 'secure' => env('CLOUDINARY_SECURE', true), 'resource_types' => [ 'image' => [ 'png', 'jpeg', 'jpg', ], 'video' => [ 'mp4', 'avi', 'mp3', 'flac', ], 'raw' => [ 'pdf', 'xlsx', 'csv', 'txt', ], ], ], ``` The secure option is applied when generating url from storage, when `secure = true` will use `https`otherwise `secure = false` will use `http` as protocol. The resource\_types option is applied when generating resource type & public id whenever we call storage method such as write, writeStream, url, has, etc. Registers the appropriate file extensions according to cloudinary resource type e.g: png in image, mp4 in video, xlsx in raw, for audio files registers in video. `The default resource type is image`, visit [image upload api reference](https://cloudinary.com/documentation/image_upload_api_reference#upload_method) for more information. Tips ---- [](#tips) To use pre-defined filename as public ID when uploading to cloudinary, you need to tweak some configuration in `Settings -> Upload -> Upload presets` as follows: - Click edit button on signed mode preset, initial preset is `ml_default` you can update it. - Turn on `Use filename or externally defined public ID` to using the pre-defined filename instead of random characters. - Turn off `Unique filename` to prevent cloudinary from adding random characters at the end of filename. - Click `Save` and you're good to go. License ------- [](#license) The Laravel Cloudinary is open-sourced software licensed under the [MIT license](http://opensource.org/licenses/MIT). ### Health Score 48 — FairBetter than 93% of packages Maintenance44 Moderate activity, may be stable Popularity41 Moderate usage in the ecosystem Community17 Small or concentrated contributor base Maturity75 Established project with proven stability Bus Factor1 Top contributor holds 95.8% 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 ~227 days Recently: every ~283 days Total 9 Last Release 445d ago Major Versions v1.0.0 → v2.0.02020-09-18 v2.2.0 → v3.0.02022-03-09 v3.0.0 → v4.0.02023-04-23 v4.0.0 → v5.0.02024-07-18 v5.0.0 → v6.0.02025-04-14 PHP version history (6 changes)v1.0.0PHP >=7.1.3 v2.0.0PHP >=7.1 v2.1.0PHP >=7.2 v3.0.0PHP >=8.0 v4.0.0PHP >=8.1 v6.0.0PHP >=8.2 ### Community Maintainers ![](https://www.gravatar.com/avatar/e021c8ceb146b0532ac3d225635988b51de61dac3e95933907859b96dc12bab6?d=identicon)[yoelpc4](/maintainers/yoelpc4) --- Top Contributors [![yoelpc4](https://avatars.githubusercontent.com/u/31505544?v=4)](https://github.com/yoelpc4 "yoelpc4 (91 commits)")[![laravel-shift](https://avatars.githubusercontent.com/u/15991828?v=4)](https://github.com/laravel-shift "laravel-shift (2 commits)")[![aurawindsurfing](https://avatars.githubusercontent.com/u/14302496?v=4)](https://github.com/aurawindsurfing "aurawindsurfing (1 commits)")[![fritzdultimate](https://avatars.githubusercontent.com/u/59008938?v=4)](https://github.com/fritzdultimate "fritzdultimate (1 commits)") --- Tags cloudinarycloudinary-integrationlaravelphpfilesystemlaravelcloudcloudinary ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/yoelpc4-laravel-cloudinary/health.svg) ``` [![Health](https://phpackages.com/badges/yoelpc4-laravel-cloudinary/health.svg)](https://phpackages.com/packages/yoelpc4-laravel-cloudinary) ``` ### Alternatives [psalm/plugin-laravel Psalm plugin for Laravel 3355.3M345](/packages/psalm-plugin-laravel)[roots/acorn Framework for Roots WordPress projects built with Laravel components. 9762.4M131](/packages/roots-acorn)[unisharp/laravel-filemanager A file upload/editor intended for use with Laravel 5 to 10 and CKEditor / TinyMCE 2.2k3.5M85](/packages/unisharp-laravel-filemanager)[laravel/ai The official AI SDK for Laravel. 1.0k3.2M193](/packages/laravel-ai)[moonshine/moonshine Laravel administration panel 1.3k253.1k81](/packages/moonshine-moonshine)[laravel/mcp Rapidly build MCP servers for your Laravel applications. 77022.3M151](/packages/laravel-mcp) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)