PHPackages                             fivepercent/var-tag-validator - 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 & Sanitization](/categories/validation)
4. /
5. fivepercent/var-tag-validator

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

fivepercent/var-tag-validator
=============================

Validate objects by var tag

v1.0(10y ago)12771MITPHPPHP >=5.4

Since Jun 4Pushed 10y ago6 watchersCompare

[ Source](https://github.com/InnoGr/FivePercent-VarTagValidator)[ Packagist](https://packagist.org/packages/fivepercent/var-tag-validator)[ RSS](/packages/fivepercent-var-tag-validator/feed)WikiDiscussions master Synced 1mo ago

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

Var Tag Validator
=================

[](#var-tag-validator)

With this package you can validate objects by **@var** tags.

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

[](#installation)

Add **FivePercent/VarTagValidator** in your composer.json:

```
{
    "require": {
        "fivepercent/var-tag-validator": "~1.0"
    }
}
```

Now tell composer to download the library by running the command:

```
$ php composer.phar update fivepercent/var-tag-validator
```

Basic usage
-----------

[](#basic-usage)

Basic create **VarTagValidator** instance:

```
use FivePercent\Component\VarTagValidator\VarTagValidator;
use FivePercent\Component\VarTagValidator\Metadata\MetadataFactory;
use Symfony\Component\Validator\ValidatorBuilder;

$validator = (new ValidatorBuilder())
    ->getValidator();

$metadataFactory = new MetadataFactory();
$varTagValidator = new VarTagValidator($validator, $metadataFactory);
```

After create **VarTagValidator** instance you can validate objects by **@var** tags:

```
class MyClass
{
    /**
     * @var int
     */
    public $id;

    /**
     * @var string
     */
    public $firstName;
}

$object = new MyClass();
$object->id = 1;
$object->firstName = 'Foo Bar';

$violationList = $varTagValidator->validateObjectByVarTags($object);
```

**Attention:** **VarTagValidator** system use [Symfony Validator](https://packagist.org/packages/symfony/validator) for validate values.

Available **@var** tag types:

1. **integer**, **int**
2. **string**
3. **scalar**
4. **array**

Custom Var Tag
--------------

[](#custom-var-tag)

If you want add custom **@var** tag type, *Money* as example, you must create a **ConstraintFactory** for this typeand add to registry.**Step #1:** Create constraint factory

```
use FivePercent\Component\VarTagValidator\Constraint\ConstraintFactoryInterface;
use Symfony\Component\Validator\Constraints as Assert;
use FivePercent\Component\VarTagValidator\Constraint\VarTagConstraint;

class MoneyConstraintFactory implements ConstraintFactoryInterface
{
    /**
     * {@inheritDoc}
     */
    public function getVarTagConstraint()
    {
        $constraints = array(
            new Assert\Type('numeric')
        );

        return new VarTagConstraint($constraints);
    }
}
```

And, if necessary, you can set a [group sequence](http://symfony.com/doc/current/book/validation.html#group-sequence) for Symfony2 Validator.

```
use FivePercent\Component\VarTagValidator\Constraint\ConstraintFactoryInterface;
use Symfony\Component\Validator\Constraints as Assert;
use FivePercent\Component\VarTagValidator\Constraint\VarTagConstraint;
use Symfony\Component\Validator\Constraints\GroupSequence;

class MoneyConstraintFactory implements ConstraintFactoryInterface
{
    /**
     * {@inheritDoc}
     */
    public function getVarTagConstraint()
    {
        $constraints = [];

        $constraints[] = new Assert\Type([
            'type' => 'numeric',
            'message' => 'This value should be of type money.',
            'groups' => 'FirstStep'
        ]);

        $constraints[] = new Assert\Regex([
            'pattern' => '/^\d+\.\d{2}$/',
            'message' => 'This value should be of type money.',
            'groups' => 'SecondStep'
        ]);

        $groupSequence = new GroupSequence(['FirstStep', 'SecondStep']);

        return new VarTagConstraint($constraints, $groupSequence);
    }
}
```

**Step #2:** Add constraint factory to registry

```
use FivePercent\Component\VarTagValidator\VarTagValidator;
use FivePercent\Component\VarTagValidator\Metadata\MetadataFactory;
use Symfony\Component\Validator\ValidatorBuilder;
use FivePercent\Component\VarTagValidator\Constraint\FactoryRegistry;

$registry = FactoryRegistry::createDefault();
$registry->addConstraintFactory('money', new MoneyConstraintFactory());

$validator = (new ValidatorBuilder())
    ->getValidator();

$metadataFactory = new MetadataFactory();
$varTagValidator = new VarTagValidator($validator, $metadataFactory, $registry);
```

Tips & Tricks
-----------------

[](#tips--tricks)

1. You can add alias to registry for type.As example: *int -> integer*, or *float -> double*For more info, please see `FivePercent\Component\VarTagValidator\Constraint\FactoryRegistryInterface::addConstraintFactoryAlias`

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity14

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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

Unknown

Total

1

Last Release

4002d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/16cc6c4d32a2c7f1cd584f31db9428341ad57682521f0f6e607cfe19f1f9157d?d=identicon)[inno-group](/maintainers/inno-group)

---

Top Contributors

[![ZhukV](https://avatars.githubusercontent.com/u/2256109?v=4)](https://github.com/ZhukV "ZhukV (2 commits)")

---

Tags

var tagvar tag validator

### Embed Badge

![Health badge](/badges/fivepercent-var-tag-validator/health.svg)

```
[![Health](https://phpackages.com/badges/fivepercent-var-tag-validator/health.svg)](https://phpackages.com/packages/fivepercent-var-tag-validator)
```

###  Alternatives

[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)