codeplace-io/polish-validator-bundle

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

This package's canonical repository appears to be gone and the package has been frozen as a result.

1.2.3 2022-02-07 14:21 UTC

Requires

• php: >=5.6
• kiczort/polish-validator: ^1.1
• symfony/config: ~3.2 || ~4.0 || ~5.0 || ~6.0
• symfony/dependency-injection: ~3.2 || ~4.0 || ~5.0 || ~6.0
• symfony/http-kernel: ~3.2 || ~4.0 || ~5.0 || ~6.0
• symfony/validator: ~3.2 || ~4.0 || ~5.0 || ~6.0

Requires (Dev)

• phpunit/phpunit: ~5.7 || ~7.0
• symfony/phpunit-bridge: ~3.2 || ~4.0

MIT

• Grzegorz Koziński
• Maciej Żukiewicz

• validator
• Symfony Bundle
• pesel
• regon
• nip
• polish validator
• pl validator
• symfony validator
• pwz

README

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

Installation

The recommended way to install this library is Composer.

# 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

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 Kiczort\PolishValidatorBundle\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:

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

use Kiczort\PolishValidatorBundle\Validator\Constraints as KiczortAssert;

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

Example of use RegonValidator:

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

use Kiczort\PolishValidatorBundle\Validator\Constraints as KiczortAssert;

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

Example of use PwzValidator:

PWZ means "licence to practise a profession" (pl. "prawo wykonywania zawodu"), number given to doctors from NIL (polish Chamber of Physicians and Dentists). Validator accepts also empty strings and nulls so you have to add "Assert/NotBlank" myself.

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

use Kiczort\PolishValidatorBundle\Validator\Constraints  as KiczortAssert;

class Doctor
{
    /**
     * @KiczortAssert\Pwz
     */
     protected $pwz;
}

Bug tracking

GitHub issues. If you have found bug, please create an issue.

MIT License

License can be found here.