PHPackages                             mikoweb/polish-validator-bundle - 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. mikoweb/polish-validator-bundle

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

mikoweb/polish-validator-bundle
===============================

Symfony bundle with validators for Polish identification numbers: PESEL, NIP, REGON.

v1.1.1(9y ago)0142MITPHP >=5.3.1

Since Jul 19Compare

[ Source](https://github.com/mikoweb/polish-validator-bundle)[ Packagist](https://packagist.org/packages/mikoweb/polish-validator-bundle)[ RSS](/packages/mikoweb-polish-validator-bundle/feed)WikiDiscussions Synced 2w ago

READMEChangelog (2)Dependencies (4)Versions (7)Used By (0)

Symfony2 bundle with Polish validators
======================================

[](#symfony2-bundle-with-polish-validators)

[![License](https://camo.githubusercontent.com/39857c3f050ca1fec2b4be4935dfbf7a3b7ff23b8bb5afdc6aa9dad35a629702/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6b69637a6f72742f706f6c6973682d76616c696461746f722d62756e646c652e737667)](https://packagist.org/packages/kiczort/polish-validator-bundle)[![Version](https://camo.githubusercontent.com/7609fc6f63a68a330d87885fd5e216b9c58493b33d26023485b781a90ec6b463/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6b69637a6f72742f706f6c6973682d76616c696461746f722d62756e646c652e737667)](https://packagist.org/packages/kiczort/polish-validator-bundle)[![Build status](https://camo.githubusercontent.com/66f69e895815a905c4ba9e7eca497fe973d5e3826b0e2e8f5762fe38fc890cf9/68747470733a2f2f7472617669732d63692e6f72672f6b69637a6f72742f706f6c6973682d76616c696461746f722d62756e646c652e737667)](http://travis-ci.org/kiczort/polish-validator-bundle)[![Scrutinizer Quality Score](https://camo.githubusercontent.com/88ae6d726254c9e137acc5f3e52e6e7ee044e4e6ea34519f7296d9cbdb767501/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f6b69637a6f72742f706f6c6973682d76616c696461746f722d62756e646c652e737667)](https://scrutinizer-ci.com/g/kiczort/polish-validator-bundle/)

This is Symfony2 bundle with validators for Polish identification numbers like: PESEL, NIP, REGON.

Installation
============

[](#installation)

The recommended way to install this library is [Composer](http://getcomposer.org).

```
# Install Composer
curl -sS https://getcomposer.org/installer | php
```

Next, run the Composer command to install the latest stable version:

```
php composer.phar require kiczort/polish-validator-bundle
```

Add bundle to AppKernel.php

```
    public function registerBundles()
        {
            $bundles = array(
                ...
                new Kiczort\PolishValidatorBundle\KiczortPolishValidatorBundle(),
                ...
            );

            return $bundles;
        }
```

Documentation
=============

[](#documentation)

Example of use PeselValidator:
------------------------------

[](#example-of-use-peselvalidator)

There are PESEL numbers with errors in real word, so in case of this validator checksum checking is only for strict mode. In case of none strict mode it checks length, used chars and correctness of date of birth.

```
...
// src/AppBundle/Entity/Person.php
namespace AppBundle\Entity;

use KiczortPolishValidatorBundle\Validator\Constraints as KiczortAssert;

class Person
{
    /**
     * @KiczortAssert\Pesel(
     *     message = "The '{{ value }}' is not a valid PESEL number.",
     *     strict = true
     * )
     */
     protected $pesel;
}
```

Example of use NipValidator:
----------------------------

[](#example-of-use-nipvalidator)

```
...
// src/AppBundle/Entity/Person.php
namespace AppBundle\Entity;

use KiczortPolishValidatorBundle\Validator\Constraints as KiczortAssert;

class Person
{
    /**
     * @KiczortAssert\Nip
     */
     protected $nip;
}
```

Example of use RegonValidator:
------------------------------

[](#example-of-use-regonvalidator)

```
...
// src/AppBundle/Entity/Company.php
namespace AppBundle\Entity;

use KiczortPolishValidatorBundle\Validator\Constraints as KiczortAssert;

class Company
{
    /**
     * @KiczortAssert\Regon
     */
     protected $regon;
}
```

Bug tracking
============

[](#bug-tracking)

[GitHub issues](https://github.com/kiczort/polish-validator-bundle/issues). If you have found bug, please create an issue.

MIT License
===========

[](#mit-license)

License can be found [here](https://github.com/kiczort/polish-validator-bundle/blob/master/LICENSE).

###  Health Score

27

—

LowBetter than 46% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity62

Established project with proven stability

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

Total

4

Last Release

3529d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/4729995?v=4)[Rafał Mikołajun](/maintainers/mikoweb)[@mikoweb](https://github.com/mikoweb)

---

Tags

validatorSymfony Bundlesymfony-validatorregonnippeselpolish validatorpl validator

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/mikoweb-polish-validator-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/mikoweb-polish-validator-bundle/health.svg)](https://phpackages.com/packages/mikoweb-polish-validator-bundle)
```

###  Alternatives

[easycorp/easyadmin-bundle

Admin generator for Symfony applications

4.3k18.3M418](/packages/easycorp-easyadmin-bundle)[rcsofttech/audit-trail-bundle

Enterprise-grade, high-performance Symfony audit trail bundle. Automatically track Doctrine entity changes with split-phase architecture, multiple transports (HTTP, Queue, Doctrine), and sensitive data masking.

12017.1k](/packages/rcsofttech-audit-trail-bundle)[kiczort/polish-validator-bundle

Symfony bundle with validators for Polish identification numbers: PESEL, NIP, REGON, PWZ.

1224.3k](/packages/kiczort-polish-validator-bundle)[kimai/kimai

Kimai - Time Tracking

4.8k9.4k1](/packages/kimai-kimai)[web-auth/webauthn-framework

FIDO2/Webauthn library for PHP and Symfony Bundle.

515113.7k3](/packages/web-auth-webauthn-framework)[shopware/storefront

Storefront for Shopware

674.7M283](/packages/shopware-storefront)

PHPackages © 2026

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