PHPackages                             infinityloop-dev/graphpinator-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. [API Development](/categories/api)
4. /
5. infinityloop-dev/graphpinator-upload

ActiveLibrary[API Development](/categories/api)

infinityloop-dev/graphpinator-upload
====================================

Module to handle multipart formdata requests.

v2.0(8mo ago)213.5k—0.9%1[1 issues](https://github.com/graphpql/graphpinator-upload/issues)[1 PRs](https://github.com/graphpql/graphpinator-upload/pulls)3MITPHPPHP >=8.2CI passing

Since May 31Pushed 5mo ago1 watchersCompare

[ Source](https://github.com/graphpql/graphpinator-upload)[ Packagist](https://packagist.org/packages/infinityloop-dev/graphpinator-upload)[ Docs](https://github.com/graphpql/)[ RSS](/packages/infinityloop-dev-graphpinator-upload/feed)WikiDiscussions master Synced 1w ago

READMEChangelog (5)Dependencies (14)Versions (8)Used By (3)

GraPHPinator Upload [![PHP](https://github.com/graphpql/graphpinator-upload/actions/workflows/php.yml/badge.svg)](https://github.com/graphpql/graphpinator-upload/actions/workflows/php.yml) [![codecov](https://camo.githubusercontent.com/3de8bb2819a2da2f9fa19b1fd26c26b92b50cd162b56b0b09165f9997a622217/68747470733a2f2f636f6465636f762e696f2f67682f696e66696e6974796c6f6f702d6465762f677261706870696e61746f722d75706c6f61642f6272616e63682f6d61737465722f67726170682f62616467652e737667)](https://codecov.io/gh/infinityloop-dev/graphpinator-upload)
===========================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================

[](#graphpinator-upload--)

⚡🌐⚡ Module to handle multipart formdata requests.

Introduction
------------

[](#introduction)

This Module allows GraPHPinator to handle uploads using [multipart-formdata](https://github.com/jaydenseric/graphql-multipart-request-spec) requests. This module hooks into Graphpinator workflow before parsing the request, reads the map and places uploaded files into according variable.

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

[](#installation)

Install package using composer

`composer require infinityloop-dev/graphpinator-upload`

How to use
----------

[](#how-to-use)

1. Implement `FileProvider`

`FileProvider` is a service that extracts files from a multipart request by their key. Each HTTP framework provides its own implementation and `FileProvider` serves as an adapter. Framework specific implementations can be found in Graphpinator packages for according framework, eg `infinityloop-dev/graphpinator-nette` contains `FileProvider` implementation for Nette's HTTP abstraction.

2. Register `UploadModule` as GraPHPinator module:

```
$uploadModule = new \Graphpinator\Upload\UploadModule($fileProvider);
$graphpinator = new \Graphpinator\Graphpinator(
    $schema,
    $catchExceptions,
    new \Graphpinator\Module\ModuleSet([$uploadModule, /* possibly other modules */]),
    $logger,
);
```

3. Register `UploadType` to your `Container`:

> This step is probably done by registering `UploadType` as service to your DI solution.

4. Optional step: Use `infinityloop-dev/graphpinator-constraint-directives` to validate uploaded files.

> For more information visit [constraint directives package](https://github.com/infinityloop-dev/graphpinator-constraint-directives).

Known limitations
-----------------

[](#known-limitations)

- Currently, this Module can place files only to variable values and not to arguments directly.
    - This is done to ensure implementation simplicity & compatibility with other modules.
    - There is probably no benefit in placing the files directly to arguments. If you stumble upon some important edge scenario, please open an issue and we can discuss possible solution here.

###  Health Score

46

—

FairBetter than 92% of packages

Maintenance57

Moderate activity, may be stable

Popularity29

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity70

Established project with proven stability

 Bus Factor1

Top contributor holds 58% 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 ~415 days

Total

5

Last Release

242d ago

Major Versions

v1.1 → v2.02025-12-18

PHP version history (3 changes)v1.0PHP >=8.0.1

v1.1PHP >=8.1

v2.0PHP >=8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/00654c913028f8d25a226eb2ddf368e1b999bf72fa4f77dbd1449c1df218756c?d=identicon)[peldax](/maintainers/peldax)

---

Top Contributors

[![peldax](https://avatars.githubusercontent.com/u/10790033?v=4)](https://github.com/peldax "peldax (101 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (72 commits)")[![HonzaBejvl](https://avatars.githubusercontent.com/u/23004049?v=4)](https://github.com/HonzaBejvl "HonzaBejvl (1 commits)")

---

Tags

graphqlgraphql-phpphp

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/infinityloop-dev-graphpinator-upload/health.svg)

```
[![Health](https://phpackages.com/badges/infinityloop-dev-graphpinator-upload/health.svg)](https://phpackages.com/packages/infinityloop-dev-graphpinator-upload)
```

###  Alternatives

[aws/aws-sdk-php

AWS SDK for PHP - Use Amazon Web Services in your PHP project

6.2k555.0M2.8k](/packages/aws-aws-sdk-php)[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.5k6.0M777](/packages/sylius-sylius)[algolia/algoliasearch-client-php

API powering the features of Algolia.

69735.8M179](/packages/algolia-algoliasearch-client-php)[neuron-core/neuron-ai

The PHP Agentic Framework.

2.0k832.6k54](/packages/neuron-core-neuron-ai)[telnyx/telnyx-php

Official Telnyx PHP SDK — APIs for Voice, SMS, MMS, WhatsApp, Fax, SIP Trunking, Wireless IoT, Call Control, and more. Build global communications on Telnyx's private carrier-grade network.

36826.2k2](/packages/telnyx-telnyx-php)[tempest/framework

The PHP framework that gets out of your way.

2.3k37.6k21](/packages/tempest-framework)

PHPackages © 2026

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