PHPackages                             bildvitta/iss-upload - 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. bildvitta/iss-upload

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

bildvitta/iss-upload
====================

This is my package IssUpload

v0.0.6(8mo ago)015.0k↓22.7%MITPHPPHP ^7.4|^8.0

Since May 3Pushed 8mo ago14 watchersCompare

[ Source](https://github.com/bildvitta/iss-upload)[ Packagist](https://packagist.org/packages/bildvitta/iss-upload)[ Docs](https://github.com/bildvitta/iss-upload)[ GitHub Sponsors](https://github.com/bildvitta)[ RSS](/packages/bildvitta-iss-upload/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (6)Dependencies (10)Versions (11)Used By (0)

This is my package IssUpload
============================

[](#this-is-my-package-issupload)

[![Latest Version on Packagist](https://camo.githubusercontent.com/b445d3b2430dc08be9383d7f360d3213fbd3c89af33f9830c9f7826e0e11fba6/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f62696c6476697474612f6973732d75706c6f61642e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/bildvitta/iss-upload)[![GitHub Tests Action Status](https://camo.githubusercontent.com/7d19b0108cbe055002d4abfaa9929193b0d3782a09d85f9a2bc10677b5aeb28d/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f62696c6476697474612f6973732d75706c6f61642f72756e2d74657374733f6c6162656c3d7465737473)](https://github.com/bildvitta/iss-upload/actions?query=workflow%3Arun-tests+branch%3Amaster)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/3a60690ccbfce9ceecf38bff9acd9bb86111ba7f11510894331c1341903a4549/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f62696c6476697474612f6973732d75706c6f61642f436865636b253230262532306669782532307374796c696e673f6c6162656c3d636f64652532307374796c65)](https://github.com/bildvitta/iss-upload/actions?query=workflow%3A%22Check+%26+fix+styling%22+branch%3Amaster)[![Total Downloads](https://camo.githubusercontent.com/dfe553681c9a5104a46224893aa629864ff7670b8798d9e353e97c4222c8bf10/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f62696c6476697474612f6973732d75706c6f61642e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/bildvitta/iss-upload)

This is where your description should go. Limit it to a paragraph or two. Consider adding a small example.

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

[](#installation)

You can install the package via composer:

```
composer require bildvitta/iss-upload
```

You can publish the config file with:

```
php artisan vendor:publish --provider="Bildvitta\IssUpload\IssUploadServiceProvider" --tag="iss-upload-config"
```

This is the contents of the published config file:

```
return [

    'validation' => [
        'mime_type' => env('ISS_IMAGE_VALID_MIME_TYPE', 'image/jpeg,image/gif,image/bmp,image/tiff,image/png,application/pdf'),
    ],

    'route' => [

        'prefix' => env('ISS_IMAGE_ROUTE_PREFIX', 'api'),

        'middleware' => env('ISS_IMAGE_ROUTE_MIDDLEWARE', 'hub.auth'),

    ]

];
```

If you want to change any settings, do so through your .env file.

```
ISS_IMAGE_ROUTE_PREFIX=api
ISS_IMAGE_ROUTE_MIDDLEWARE="hub.auth"
ISS_IMAGE_VALID_MIME_TYPE="image/jpeg,image/gif,image/bmp,image/tiff,image/png,application/pdf"

AWS_ACCESS_KEY_ID=
AWS_SECRET_ACCESS_KEY=
AWS_DEFAULT_REGION=us-east-1
AWS_BUCKET=
```

It is mandatory to fill in AWS credential information.

Usage
-----

[](#usage)

The package already contains a `{prefix}/upload-credentials` and `{prefix}/upload` route by default.

Below is an example in cURL requesting the upload link to AWS.

```
curl --location --request POST 'http://127.0.0.1:8001/api/upload-credentials' \
--header 'Content-Type: application/json' \
--data-raw '{
    "filename": "5044e35d-8cc1-4cf3-b9e6-358872f022ac.png",
    "entity": "realEstateDevelopmentsMedias"
}'

```

Here is an example of an answer.

```
{
  "path": "uploads/realEstateDevelopmentsMedias/5044e35d-8cc1-4cf3-b9e6-358872f022ac.png",
  "full_path": "https://s3.amazonaws.com/bucket.com.br/uploads/realEstateDevelopmentsMedias/5044e35d-8cc1-4cf3-b9e6-358872f022ac.png",
  "endpoint": "https://s3.amazonaws.com/bucket.com.br/uploads/realEstateDevelopmentsMedias/5044e35d-8cc1-4cf3-b9e6-358872f022ac.png?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=XXXXXFus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20210430T111315Z&X-Amz-SignedHeaders=host&X-Amz-Expires=600&X-Amz-Signature=XXXX"
}
```

#### Custom routes

[](#custom-routes)

You may also want to have your own upload routes, one for each form for example

```
use Bildvitta\IssUpload\Http\Controllers\UploadController;

Route::post('/upload-pdf')->name('upload_pdf')->uses(UploadController::class);
```

#### Using run time

[](#using-run-time)

It may also happen that you want to have the upload source at any time in the request time.

For any purpose you can use the code below which will have an array with the same content as the controller response

Feel free to use `\Bildvitta\IssUpload\Http\Requests\UploadRequest`.

```
use Bildvitta\IssUpload\Http\Requests\UploadRequest;
use Bildvitta\IssUpload\IssUpload;
use Illuminate\Http\JsonResponse;
use App\Http\Requests\YourRequestValidator;

class NewPostController extends Controller
{
    public function __invoke(YourRequestValidator $yourRequestValidator, UploadRequest $uploadRequest): JsonResponse
    {
        #TODO: Your Logic.

//        $issUpload = new IssUpload($uploadRequest->entity, ($uploadRequest->filename, $uploadRequest->mime_type);

        $issUpload = new IssUpload();
        $issUpload->setEntity($uploadRequest->entity);
        $issUpload->setFilename($uploadRequest->filename);
        $issUpload->setMimeType($uploadRequest->mime_type);

        dd($issUpload->getUploadSource());

        #TODO: Your Logic.
    }
}
```

The dump returns something like this.

```
array:3 [
  "path": "uploads/realEstateDevelopmentsMedias/5044e35d-8cc1-4cf3-b9e6-358872f022ac.png",
  "full_path": "https://s3.amazonaws.com/bucket.com.br/uploads/realEstateDevelopmentsMedias/5044e35d-8cc1-4cf3-b9e6-358872f022ac.png",
  "endpoint": "https://s3.amazonaws.com/bucket.com.br/uploads/realEstateDevelopmentsMedias/5044e35d-8cc1-4cf3-b9e6-358872f022ac.png?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=XXXXXFus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20210430T111315Z&X-Amz-SignedHeaders=host&X-Amz-Expires=600&X-Amz-Signature=XXXX"
]

```

Testing
-------

[](#testing)

coming soon...

Changelog
---------

[](#changelog)

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

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

[](#contributing)

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

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

[](#security-vulnerabilities)

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

Credits
-------

[](#credits)

- [SOSTheBLack](https://github.com/SOSTheBlack)
- [All Contributors](../../contributors)

License
-------

[](#license)

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

###  Health Score

41

—

FairBetter than 89% of packages

Maintenance62

Regular maintenance activity

Popularity25

Limited adoption so far

Community17

Small or concentrated contributor base

Maturity53

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

Recently: every ~390 days

Total

6

Last Release

242d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/57ede45a8ce528ade98fadbb32397afb6c0234f9d05caae7ac207d3b4d026af1?d=identicon)[hynzhw](/maintainers/hynzhw)

![](https://www.gravatar.com/avatar/e32e39fb848943b1a94bb2c167a2bda11eb45814ba34d539e6b1685a5de6e272?d=identicon)[michaelnakamura](/maintainers/michaelnakamura)

![](https://www.gravatar.com/avatar/ab5f117bbac50e0314758bcc25c9052dc4546568082eff672b65b128be0e2d98?d=identicon)[fabiomartins](/maintainers/fabiomartins)

![](https://www.gravatar.com/avatar/3ce1635f07565fb1531991b47d86c407b9b30955eb1871dad4ed33810aaffe88?d=identicon)[leandrohago](/maintainers/leandrohago)

---

Top Contributors

[![zerossB](https://avatars.githubusercontent.com/u/8009480?v=4)](https://github.com/zerossB "zerossB (6 commits)")[![paulodavanco](https://avatars.githubusercontent.com/u/11135122?v=4)](https://github.com/paulodavanco "paulodavanco (5 commits)")[![SOSTheBlack](https://avatars.githubusercontent.com/u/5401143?v=4)](https://github.com/SOSTheBlack "SOSTheBlack (2 commits)")

---

Tags

laravelbildvittaiss-upload

###  Code Quality

TestsPHPUnit

Static AnalysisPsalm

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/bildvitta-iss-upload/health.svg)

```
[![Health](https://phpackages.com/badges/bildvitta-iss-upload/health.svg)](https://phpackages.com/packages/bildvitta-iss-upload)
```

###  Alternatives

[spatie/livewire-filepond

Upload files using Filepond in Livewire components

306452.7k3](/packages/spatie-livewire-filepond)[elegantly/laravel-invoices

Store invoices safely in your Laravel application

23131.8k](/packages/elegantly-laravel-invoices)[vormkracht10/laravel-mails

Laravel Mails can collect everything you might want to track about the mails that has been sent by your Laravel app.

24149.7k](/packages/vormkracht10-laravel-mails)[mwguerra/filemanager

A full-featured file manager package for Laravel and Filament v5 with dual operating modes, drag-and-drop uploads, S3/MinIO support, and comprehensive security features.

718.5k1](/packages/mwguerra-filemanager)[codebar-ag/laravel-flysystem-cloudinary

Cloudinary Flysystem v1 integration with Laravel

1224.9k2](/packages/codebar-ag-laravel-flysystem-cloudinary)[mreduar/s3m

Multipart Uploads using Laravel and AWS S3

173.6k](/packages/mreduar-s3m)

PHPackages © 2026

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