PHPackages                             vormkracht10/flysystem-uploadcare - 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 &amp; Storage](/categories/file-storage)
4. /
5. vormkracht10/flysystem-uploadcare

ActiveLibrary[File &amp; Storage](/categories/file-storage)

vormkracht10/flysystem-uploadcare
=================================

Flysystem driver for Uploadcare for Laravel.

v0.5.0(5mo ago)1834.2k—5.8%2[6 PRs](https://github.com/ux-nl/flysystem-uploadcare/pulls)MITPHPPHP ^8.2CI passing

Since Mar 27Pushed 3mo ago2 watchersCompare

[ Source](https://github.com/ux-nl/flysystem-uploadcare)[ Packagist](https://packagist.org/packages/vormkracht10/flysystem-uploadcare)[ Docs](https://github.com/vormkracht10/flysystem-uploadcare)[ GitHub Sponsors](https://github.com/vormkracht10)[ RSS](/packages/vormkracht10-flysystem-uploadcare/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (5)Dependencies (13)Versions (22)Used By (0)

Laravel Uploadcare integration Filesystem (Flysystem adapter)
=============================================================

[](#laravel-uploadcare-integration-filesystem-flysystem-adapter)

[![Latest Version on Packagist](https://camo.githubusercontent.com/636545b401a5594f8cbae569862ce0c016913d592fd9f2b73e1a94524f7adbee/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f766f726d6b726163687431302f666c7973797374656d2d75706c6f6164636172652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/vormkracht10/flysystem-uploadcare)[![GitHub Tests Action Status](https://camo.githubusercontent.com/f24fd1ba3cf06a220735565c48c337fc4998bbda585622d863436b6257af440f/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f766f726d6b726163687431302f666c7973797374656d2d75706c6f6164636172652f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/vormkracht10/flysystem-uploadcare/actions?query=workflow%3Arun-tests+branch%3Amain)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/ff163cb1ccdef8b16bc87e84278c9e94b886b5f03176cafe52a7dad35a08ef0e/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f766f726d6b726163687431302f666c7973797374656d2d75706c6f6164636172652f6669782d7068702d636f64652d7374796c652d6973737565732e796d6c3f6272616e63683d6d61696e266c6162656c3d636f64652532307374796c65267374796c653d666c61742d737175617265)](https://github.com/vormkracht10/flysystem-uploadcare/actions?query=workflow%3A%22Fix+PHP+code+style+issues%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/29589660840f75a8f787b90454879fb6ffd2f220a391c2538a1f79c08426d517/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f766f726d6b726163687431302f666c7973797374656d2d75706c6f6164636172652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/vormkracht10/flysystem-uploadcare)

Flysystem adapter for Uploadcare with support for Laravel v9+ including Laravel 12.

Installation
------------

[](#installation)

You can install the package via composer:

```
composer require vormkracht10/flysystem-uploadcare
```

Add the following config to the `disk` array in config/filesystems.php

```
[
    'uploadcare' => [
        'driver' => 'uploadcare',
        'public' => env('UPLOADCARE_PUBLIC_KEY'),
        'secret' => env('UPLOADCARE_SECRET_KEY'),
        'cdn' => env('UPLOADCARE_CDN') // Default https://ucarecdn.com
    ]
]
```

Then set the `FILESYSTEM_DISK` to `uploadcare` and set your public/secret keys in your .env

```
UPLOADCARE_PUBLIC_KEY=
UPLOADCARE_SECRET_KEY=
FILESYSTEM_DISK=uploadcare
```

Examples
--------

[](#examples)

**Please note**: Since adding files to uploadcare always returns a unique id that will be used to retrieve files you might wanna use the `*GetUuid()` function(s) for writing files.

```
$uuid = Storage::disk('uploadcare')->putGetUuid('example.txt', 'My notes.');

$uuid = Storage::disk('uploadcare')->putFileGetUuid('files', new File('/var/www/uploadcare-app/routes/newcontent.txt'));

$uuid = Storage::disk('uploadcare')->putFileAsGetUuid('files', new File('/var/www/uploadcare-app/routes/newcontent.txt'), 'my-awesome-name.txt');
```

**Get the content of a file**

```
$contents = Storage::disk('uploadcare')->get('');
```

**Deleting a file:**

```
Storage::disk('uploadcare')->delete('');
```

**Getting the mimetype of a file**

```
$mimeType = Storage::disk('uploadcare')->mimeType('');
```

**Get the filesize of a file**

```
$bytes = Storage::disk('uploadcare')->filesize('');
```

**Get the original filename**

```
$info = Storage::disk('uploadcare')->fileInfo($result[0]);
$filename = $info->extraMetadata()['originalFilename'];
```

**Get a list of files**

Directories in uploadcare are stored with an "~"-sign at the end of a uuid. Getting files from a directory could be retreived as follow:

```
$files = Storage::disk('uploadcare')->files('0123a456-a0bc-0a1b-0ab1-0a1234a5b6c7~');
foreach ($files as $uuid) {
    echo 'https://ucarecdn.com/' . $uuid .'';
}
```

**Working with images?**See [github.com/vormkracht10/php-uploadcare-transformations](https://github.com/vormkracht10/php-uploadcare-transformations)

Testing
-------

[](#testing)

```
composer test
```

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Please review [our security policy](../../security/policy) on how to report security vulnerabilities.

Credits
-------

[](#credits)

- [Vormkracht10](https://github.com/vormkracht10)
- [Mathieu](https://github.com/casmo)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

50

—

FairBetter than 96% of packages

Maintenance77

Regular maintenance activity

Popularity37

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor2

2 contributors hold 50%+ of commits

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 ~75 days

Recently: every ~133 days

Total

14

Last Release

168d ago

PHP version history (2 changes)v0.0.1PHP ^8.1

v0.5.0PHP ^8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/7c6a425dc8645907a118a007438172d58c2016773f54ab3a834beff172632f13?d=identicon)[ux](/maintainers/ux)

---

Top Contributors

[![Casmo](https://avatars.githubusercontent.com/u/385764?v=4)](https://github.com/Casmo "Casmo (28 commits)")[![markvaneijk](https://avatars.githubusercontent.com/u/1925388?v=4)](https://github.com/markvaneijk "markvaneijk (14 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (10 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (5 commits)")[![Baspa](https://avatars.githubusercontent.com/u/10845460?v=4)](https://github.com/Baspa "Baspa (3 commits)")[![Chris8934](https://avatars.githubusercontent.com/u/44963939?v=4)](https://github.com/Chris8934 "Chris8934 (1 commits)")[![Ynitial](https://avatars.githubusercontent.com/u/35238373?v=4)](https://github.com/Ynitial "Ynitial (1 commits)")

---

Tags

filesflysystemflysystem-adapterlaravelphpuploadcareuploadcare-apiuploadslaravelstorageuploadcarevormkracht10flysystem-uploadcare

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/vormkracht10-flysystem-uploadcare/health.svg)

```
[![Health](https://phpackages.com/badges/vormkracht10-flysystem-uploadcare/health.svg)](https://phpackages.com/packages/vormkracht10-flysystem-uploadcare)
```

###  Alternatives

[unisharp/laravel-filemanager

A file upload/editor intended for use with Laravel 5 to 10 and CKEditor / TinyMCE

2.2k3.3M74](/packages/unisharp-laravel-filemanager)[unisharp/laravel-fileapi

Laravel File API - Handle Files with Laravel Storage

5345.3k](/packages/unisharp-laravel-fileapi)[luoyy/ali-oss-storage

aliyun oss filesystem storage for laravel 9+

1529.9k1](/packages/luoyy-ali-oss-storage)[zing/laravel-flysystem-obs

Flysystem Adapter for OBS

1211.2k](/packages/zing-laravel-flysystem-obs)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
