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 & Storage](/categories/file-storage) 4. / 5. bildvitta/iss-upload ActiveLibrary[File & Storage](/categories/file-storage) bildvitta/iss-upload ==================== This is my package IssUpload v0.0.6(9mo ago)016.0k↓32.6%MITPHPPHP ^7.4|^8.0 Since May 3Pushed 1w ago5 watchersCompare [ Source](https://github.com/appnave/nave-upload-iss)[ 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 2d ago READMEChangelog (8)Dependencies (10)Versions (12)Used By (0) Nave Upload ISS =============== [](#nave-upload-iss) Pacote privado da App Nave para gerar URLs pré-assinadas de upload em storages compatíveis com S3 em projetos Laravel. O consumo é feito via Composer com repositório VCS no projeto cliente. Visão geral ----------- [](#visão-geral) - Nome do pacote: `appnave/nave-upload-iss` - Namespace principal: `Bildvitta\IssUpload` - Rota padrão: `POST /api/upload-credentials` - Suporte a qualquer storage compatível com S3 (AWS S3, MinIO, DigitalOcean Spaces, Cloudflare R2, etc.) Requisitos ---------- [](#requisitos) - PHP 8.0+ - Laravel compatível com `illuminate/contracts` 8, 9, 10, 11 ou 12 - Disk S3-compatible configurado no projeto cliente - Acesso ao repositório privado no GitHub Acesso aos repositórios privados -------------------------------- [](#acesso-aos-repositórios-privados) No projeto cliente, adicione o repositório VCS em `composer.json`: ``` { "repositories": [ { "type": "vcs", "url": "https://github.com/ORG/REPO" } ] } ``` Depois instale o pacote: ``` composer require appnave/nave-upload-iss ``` Autenticação local do Composer com token GitHub: ``` composer config -g github-oauth.github.com ``` GitHub Actions: ``` env: COMPOSER_AUTH: >- {"github-oauth":{"github.com":"${{ secrets.GH_TOKEN }}"}} ``` Instalação ---------- [](#instalação) ### 1. Publicar a configuração [](#1-publicar-a-configuração) Use o comando inteligente de publicação, que adiciona apenas as chaves ausentes caso o arquivo já exista: ``` php artisan iss-upload:publish-config ``` Ou publique via `vendor:publish` para sobrescrever o arquivo inteiro: ``` php artisan vendor:publish --provider="Bildvitta\IssUpload\IssUploadServiceProvider" --tag="iss-upload-config" ``` ### 2. Configurar o `.env` [](#2-configurar-o-env) ``` # Storage ISS_UPLOAD_DISK=s3 # nome do disk Laravel (padrão: s3) ISS_UPLOAD_ACL=public-read # ACL do objeto no S3 (padrão: public-read) ISS_UPLOAD_PRESIGNED_EXPIRY=+10 minutes # validade da URL pré-assinada (padrão: +10 minutes) ISS_UPLOAD_PATH_PREFIX=uploads # prefixo do caminho no bucket (padrão: uploads) # Rotas ISS_IMAGE_ROUTE_PREFIX=api ISS_IMAGE_ROUTE_MIDDLEWARE=hub.auth # Validação ISS_IMAGE_VALID_MIME_TYPE="image/jpeg,image/gif,image/bmp,image/tiff,image/png,application/pdf" # Credenciais AWS (ou equivalente do seu provider) AWS_ACCESS_KEY_ID=... AWS_SECRET_ACCESS_KEY=... AWS_DEFAULT_REGION=us-east-1 AWS_BUCKET=... ``` > O middleware padrão é `hub.auth`; ajuste conforme o projeto cliente. > O `mime_type` é inferido automaticamente pela extensão do arquivo. Usando um storage alternativo (MinIO, R2, Spaces…) -------------------------------------------------- [](#usando-um-storage-alternativo-minio-r2-spaces) Configure o disk desejado em `config/filesystems.php` do projeto cliente apontando para o endpoint do seu provider. Em seguida, defina `ISS_UPLOAD_DISK` com o nome desse disk: ``` ISS_UPLOAD_DISK=minio ``` ``` // config/filesystems.php 'minio' => [ 'driver' => 's3', 'key' => env('MINIO_ACCESS_KEY_ID'), 'secret' => env('MINIO_SECRET_ACCESS_KEY'), 'region' => env('MINIO_DEFAULT_REGION', 'us-east-1'), 'bucket' => env('MINIO_BUCKET'), 'endpoint' => env('MINIO_ENDPOINT'), 'use_path_style_endpoint' => true, ], ``` Resposta da API --------------- [](#resposta-da-api) `POST /api/upload-credentials` **Request:** ``` { "filename": "arquivo.png", "entity": "realEstateDevelopmentsMedias" } ``` **Response `200`:** ``` { "path": "uploads/realEstateDevelopmentsMedias/arquivo.png", "full_path": "https://bucket.s3.amazonaws.com/uploads/realEstateDevelopmentsMedias/arquivo.png", "endpoint": "https://bucket.s3.amazonaws.com/uploads/realEstateDevelopmentsMedias/arquivo.png?X-Amz-Algorithm=..." } ``` CampoDescrição`path`Chave do objeto no bucket`full_path`URL pública do arquivo após o upload`endpoint`URL pré-assinada para o upload direto (válida por `ISS_UPLOAD_PRESIGNED_EXPIRY`)Comandos Artisan ---------------- [](#comandos-artisan) ComandoDescrição`php artisan iss-upload:publish-config`Publica o config adicionando apenas chaves ausentes se o arquivo já existir`php artisan iss-upload:check`Exibe a configuração atual e testa a conectividade com o storageOutros comandos --------------- [](#outros-comandos) ``` composer test composer test-coverage composer check-style composer fix-style composer psalm ``` Informações adicionais ---------------------- [](#informações-adicionais) - Se precisar de uma rota própria, use `Bildvitta\IssUpload\Http\Controllers\UploadController`. - A documentação de mudanças está em [CHANGELOG.md](CHANGELOG.md). - As orientações de contribuição estão em [.github/CONTRIBUTING.md](.github/CONTRIBUTING.md). - A política de segurança está em [.github/SECURITY.md](.github/SECURITY.md). - A licença está em [LICENSE.md](LICENSE.md). ### Health Score 46 — FairBetter than 92% of packages Maintenance80 Actively maintained with recent releases Popularity24 Limited adoption so far Community15 Small or concentrated contributor base Maturity54 Maturing project, gaining track record Bus Factor1 Top contributor holds 69.6% 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 ~319 days Recently: every ~390 days Total 6 Last Release 288d 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 (16 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/laravel-permission Permission handling for Laravel 12 and up 12.9k102.4M1.4k](/packages/spatie-laravel-permission)[spatie/laravel-pdf Create PDFs in Laravel apps 1.0k4.8M47](/packages/spatie-laravel-pdf)[dedoc/scramble Automatic generation of API documentation for Laravel applications. 2.1k11.2M100](/packages/dedoc-scramble)[defstudio/telegraph A laravel facade to interact with Telegram Bots 816333.6k3](/packages/defstudio-telegraph)[spatie/laravel-passkeys Use passkeys in your Laravel app 471890.7k39](/packages/spatie-laravel-passkeys)[rawilk/profile-filament-plugin Profile & MFA starter kit for filament. 3914.6k](/packages/rawilk-profile-filament-plugin) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)