{"id":19483289,"url":"https://github.com/cloudinary-community/cloudinary-laravel","last_synced_at":"2025-05-14T15:04:49.248Z","repository":{"id":38030917,"uuid":"272280035","full_name":"cloudinary-community/cloudinary-laravel","owner":"cloudinary-community","description":"Laravel SDK for Cloudinary","archived":false,"fork":false,"pushed_at":"2025-03-16T19:32:32.000Z","size":289,"stargazers_count":296,"open_issues_count":0,"forks_count":75,"subscribers_count":14,"default_branch":"master","last_synced_at":"2025-04-14T22:07:22.698Z","etag":null,"topics":["cloudinary","hacktoberfest","laravel","open-source"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cloudinary-community.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-06-14T20:41:07.000Z","updated_at":"2025-04-10T15:06:04.000Z","dependencies_parsed_at":"2023-10-02T07:47:28.569Z","dependency_job_id":"e5414af4-996f-4ea8-adf2-309b57e870d0","html_url":"https://github.com/cloudinary-community/cloudinary-laravel","commit_stats":{"total_commits":82,"total_committers":16,"mean_commits":5.125,"dds":0.3292682926829268,"last_synced_commit":"7196372675eb4e9d9ffed21121c7ee4b96f77c48"},"previous_names":["cloudinary-devs/cloudinary-laravel"],"tags_count":19,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudinary-community%2Fcloudinary-laravel","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudinary-community%2Fcloudinary-laravel/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudinary-community%2Fcloudinary-laravel/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudinary-community%2Fcloudinary-laravel/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cloudinary-community","download_url":"https://codeload.github.com/cloudinary-community/cloudinary-laravel/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248968845,"owners_count":21191162,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cloudinary","hacktoberfest","laravel","open-source"],"created_at":"2024-11-10T20:14:27.675Z","updated_at":"2025-04-14T22:07:41.087Z","avatar_url":"https://github.com/cloudinary-community.png","language":"PHP","readme":"\u003cpicture\u003e\n  \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://user-images.githubusercontent.com/62209650/196528621-b68e9e10-7e55-4c7d-9177-904cadbb4296.png\" align=\"center\" height=50\u003e\n  \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://user-images.githubusercontent.com/62209650/196528761-a815025a-271a-4d8e-ac7e-cea833728bf9.png\" align=\"center\" height=50\u003e\n  \u003cimg alt=\"Cloudinary\" src=\"https://user-images.githubusercontent.com/62209650/196528761-a815025a-271a-4d8e-ac7e-cea833728bf9.png\" align=\"center\" height=50\u003e\n\u003c/picture\u003e\n\u0026ensp;\u0026ensp;\n\u003cpicture style=\"padding: 50px\"\u003e\n  \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://user-images.githubusercontent.com/1045274/200928533-47539867-07ff-406e-aa8b-25c594652dc8.png\" align=\"center\" height=50\u003e\n  \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://user-images.githubusercontent.com/1045274/200928533-47539867-07ff-406e-aa8b-25c594652dc8.png\" align=\"center\" height=50\u003e\n  \u003cimg alt=\"Laravel\" src=\"https://user-images.githubusercontent.com/1045274/200928533-47539867-07ff-406e-aa8b-25c594652dc8.png\" align=\"center\" height=50\u003e\n\u003c/picture\u003e\n\n######\n\n\u003ca href=\"https://packagist.org/packages/cloudinary-labs/cloudinary-laravel\"\u003e\u003cimg src=\"https://img.shields.io/packagist/dt/cloudinary-labs/cloudinary-laravel.svg?style=flat-square\" alt=\"Total Downloads\"\u003e\u003c/a\u003e\n\u003ca href=\"https://packagist.org/packages/cloudinary-labs/cloudinary-laravel\"\u003e\u003cimg src=\"https://poser.pugx.org/cloudinary-labs/cloudinary-laravel/v/stable.svg?style=flat-square\" alt=\"Latest Stable Version\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/cloudinary-devs/cloudinary-laravel/blob/main/LICENSE\"\u003e\u003cimg alt=\"GitHub\" src=\"https://img.shields.io/github/license/cloudinary-devs/cloudinary-laravel?label=License\u0026style=flat-square\"\u003e\u003c/a\u003e\n\n\u003e 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.\n\n## Table of Contents\n\n- [Installation](#installation)\n- [Usage](#usage)\n  - [File Storage Driver](#file-storage-driver)\n  - [Blade Components](#blade-components)\n- [Disclaimer](#disclaimer)\n- [Contributions](#contributions)\n- [License](#license)\n\n## Installation\n\nRequires PHP 8.2+ and Laravel 11+.\n\n```bash\ncomposer require cloudinary-labs/cloudinary-laravel\n```\n\nAfter you have installed the SDK, you can invoke the install command to set everything up:\n\n```bash\nphp artisan cloudinary:install\n```\n\nAdd your Cloudinary credentials to your `.env` file:\n\n```\nCLOUDINARY_URL=cloudinary://API_KEY:API_SECRET@CLOUD_NAME\nCLOUDINARY_UPLOAD_PRESET=your_upload_preset\nCLOUDINARY_NOTIFICATION_URL=\n```\n\n\u003e [!NOTE]  \n\u003e You can get your `CLOUDINARY_URL` from your [Cloudinary console](https://cloudinary.com/console). It typically looks like this: `cloudinary://API_KEY:API_SECRET@CLOUD_NAME`. Make sure to replace `API_KEY`, `API_SECRET`, and `CLOUD_NAME` with your actual Cloudinary credentials.\n\n## Usage\n\n### File Storage Driver\n\nThis SDK implements the [File Storage](https://laravel.com/docs/12.x/filesystem#main-content) Driver interface allowing you to use it as just another storage destination like s3, azure or local disk.\n\nAdd a new `cloudinary` key to your `config/filesystems.php` disk key like so:\n\n```php\n  ...,\n  'cloudinary' =\u003e [\n      'driver' =\u003e 'cloudinary',\n      'key' =\u003e env('CLOUDINARY_KEY'),\n      'secret' =\u003e env('CLOUDINARY_SECRET'),\n      'cloud' =\u003e env('CLOUDINARY_CLOUD_NAME'),\n      'url' =\u003e env('CLOUDINARY_URL'),\n      'secure' =\u003e (bool) env('CLOUDINARY_SECURE', true),\n      'prefix' =\u003e env('CLOUDINARY_PREFIX'),\n  ],\n...,\n```\n\n### Blade Components\n\nThis package provides a few Blade components for easy integration of Cloudinary media in your Laravel views.\n\n#### Upload Widget\n\nYou can use the `\u003cx-cloudinary::widget /\u003e` Blade component that ships with this like so:\n\n```blade\n\u003c!DOCTYPE html\u003e\n\u003chtml\u003e\n  \u003cbody\u003e\n    \u003cx-cloudinary::widget\u003eUpload Files\u003c/x-cloudinary::widget\u003e\n  \u003c/body\u003e\n\u003c/html\u003e\n```\n\n#### Image Component\n\nBasic usage:\n\n```blade\n\u003cx-cloudinary::image public-id=\"example\" /\u003e\n```\n\nWith additional properties:\n\n```blade\n\u003cx-cloudinary::image public-id=\"example\" width=\"300\" height=\"300\" /\u003e\n```\n\n##### Properties available:\n\n| Property              | Required |\n| --------------------- | -------- |\n| `public-id`           | Yes      |\n| `width`               | No       |\n| `height`              | No       |\n| `alt`                 | No       |\n| `class`               | No       |\n| `crop`                | No       |\n| `gravity`             | No       |\n| `effect`              | No       |\n| `rotate`              | No       |\n| `colorize`            | No       |\n| `trim`                | No       |\n| `blur`                | No       |\n| `gray-scale`          | No       |\n| `black-white`         | No       |\n| `sepia`               | No       |\n| `redeye`              | No       |\n| `negate`              | No       |\n| `oil-paint`           | No       |\n| `vignette`            | No       |\n| `simulate-colorblind` | No       |\n| `pixelate`            | No       |\n| `unsharp-mask`        | No       |\n| `saturation`          | No       |\n| `contrast`            | No       |\n| `brightness`          | No       |\n| `gamma`               | No       |\n| `improve-mode`        | No       |\n| `shadow`              | No       |\n| `border`              | No       |\n| `round-corners`       | No       |\n| `bg-color`            | No       |\n| `art`                 | No       |\n| `cartoonify`          | No       |\n\n#### Video Component\n\nBasic usage:\n\n```blade\n\u003cx-cloudinary::video public-id=\"example\" /\u003e\n```\n\nWith additional properties:\n\n```blade\n\u003cx-cloudinary::video public-id=\"example\" width=\"300\" height=\"300\" /\u003e\n```\n\n##### Properties available:\n\n| Property    | Required |\n| ----------- | -------- |\n| `public-id` | Yes      |\n| `width`     | No       |\n| `height`    | No       |\n\n## Disclaimer\n\n\u003e _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.\u003c/br\u003e \u003c/br\u003e 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.\u003c/br\u003e \u003c/br\u003e 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._\n\n## Contributions\n\nContributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details.\n\n## License\n\nThis package is open-sourced software licensed under the [MIT license](LICENSE.md).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcloudinary-community%2Fcloudinary-laravel","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcloudinary-community%2Fcloudinary-laravel","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcloudinary-community%2Fcloudinary-laravel/lists"}