PHPackages                             ipedis/validation-handler - 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. [Validation &amp; Sanitization](/categories/validation)
4. /
5. ipedis/validation-handler

ActiveLibrary[Validation &amp; Sanitization](/categories/validation)

ipedis/validation-handler
=========================

File validation handler

2.1.0(3mo ago)03↑2900%PHPPHP &gt;=8.2CI passing

Since Jun 7Pushed 1mo agoCompare

[ Source](https://github.com/ipedis/validation-handler)[ Packagist](https://packagist.org/packages/ipedis/validation-handler)[ RSS](/packages/ipedis-validation-handler/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (7)Versions (5)Used By (0)

### Validation-handler

[](#validation-handler)

This library is useful for file validation built on top of `symfony/validator` component.

Get Started
-----------

[](#get-started)

First you have to install dependency of this library.

```
make install
```

```
make test

```

### How to use?

[](#how-to-use)

Prepare your data inside [DataWrapper](src/Data/DataWrapper.php) and create validation chain with validators.

```
use Ipedis\ValidationHandler\Data\DataWrapper;
use Ipedis\ValidationHandler\Data\Constraints\FileSize;
use Ipedis\ValidationHandler\Data\Constraints\MimeTypes;
use Ipedis\ValidationHandler\Validator\Result\ValidationResult;
use Ipedis\ValidationHandler\ConstraintFactory;

$file = __DIR__."/../tests/data/265kb.pdf";
$data = new DataWrapper(new SplFileInfo($file));

/**
 * build validator with list of constraints.
 */
$validator = ConstraintFactory::build(constraints: [
    new FileSize('100', 'k'),
    new MimeTypes(['application/pdf'])
]);
// run validations
$result = $validation->handle();

var_dump($result->isFailed(), $result->getErrorMessage());

/*
 * don't want to search for mimetype string? you can use built-in mimetypes helper
 */
// example of mimetypes helper
$validator = ConstraintFactory::build(constraints: [
    new FileSize('1', 'M'),
    MimeTypes::with(PdfMimeType::class)
]);
/** @var ValidationResult $result */
$result = $validator->handle($data);

// should pass.
var_dump($result->isFailed(), $result->getErrorMessage());

/**
* If you do not concern about filesize but only want to check if file is image or pdf
 */
var_dump(ValidationHelper::isImage($data));
var_dump(ValidationHelper::isPdf($data));
```

Result will be instanced of [ValidationResult](src/Validator/Modal/ValidationResult.php), `isFailed()` is helper to know if validation failed or not. `getError()` will give you instance of symfony's [ConstraintViolationInterface](https://github.com/symfony/validator/blob/6.1/ConstraintViolationInterface.php).

#### Adding more validator

[](#adding-more-validator)

Each validator class extends [HandlerAbstract](src/Handler/HandlerAbstract.php). You can create new class and perform your own required validations.

#### Limitations and TODO

[](#limitations-and-todo)

- For now validation is only for [uploaded files](src/Data/DataWrapperInterface.php), we can expand it to use other types.

###  Health Score

44

—

FairBetter than 92% of packages

Maintenance87

Actively maintained with recent releases

Popularity4

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor1

Top contributor holds 80.8% 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 ~669 days

Total

3

Last Release

96d ago

Major Versions

1.0.0 → 2.0.02024-06-13

PHP version history (3 changes)1.0.0PHP &gt;=8.1

2.0.0PHP ^8.2

2.1.0PHP &gt;=8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/97cc863f90ac18a7a620893a0a9cbf099dab4f8e5f853e1fe5a28c64b6dec9cc?d=identicon)[yanis-git](/maintainers/yanis-git)

---

Top Contributors

[![tejaskgosai](https://avatars.githubusercontent.com/u/126658306?v=4)](https://github.com/tejaskgosai "tejaskgosai (21 commits)")[![MelchiorIpedis](https://avatars.githubusercontent.com/u/126576609?v=4)](https://github.com/MelchiorIpedis "MelchiorIpedis (2 commits)")[![lucas-dsm](https://avatars.githubusercontent.com/u/126459347?v=4)](https://github.com/lucas-dsm "lucas-dsm (1 commits)")[![lucasdsm78](https://avatars.githubusercontent.com/u/66834518?v=4)](https://github.com/lucasdsm78 "lucasdsm78 (1 commits)")[![yanis-git](https://avatars.githubusercontent.com/u/4113879?v=4)](https://github.com/yanis-git "yanis-git (1 commits)")

###  Code Quality

TestsPest

Static AnalysisPHPStan, Rector

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/ipedis-validation-handler/health.svg)

```
[![Health](https://phpackages.com/badges/ipedis-validation-handler/health.svg)](https://phpackages.com/packages/ipedis-validation-handler)
```

###  Alternatives

[illuminate/validation

The Illuminate Validation package.

18936.7M1.4k](/packages/illuminate-validation)[drupal/core

Drupal is an open source content management platform powering millions of websites and applications.

19462.3M1.3k](/packages/drupal-core)[sllh/iso-codes-validator

Symfony validator wrapper of ronanguilloux/isocodes

37299.8k2](/packages/sllh-iso-codes-validator)[digitalrevolution/symfony-validation-shorthand

Validation shorthand for symfony

12108.5k2](/packages/digitalrevolution-symfony-validation-shorthand)[digitalrevolution/symfony-request-validation

Automatic request validation for symfony

1296.0k](/packages/digitalrevolution-symfony-request-validation)

PHPackages © 2026

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