czachor/polish-id-validators

This package is abandoned and no longer maintained. No replacement package was suggested.

PHP library based on Symfony Validator Component to validate various medical identification numbers used in Poland.

v1.3.1 2022-03-15 11:27 UTC

Requires

• php: ^7.2|^8.0
• ronanguilloux/isocodes: ^2.3
• symfony/translation: ^5.0|^6.0
• symfony/validator: ^5.0|^6.0

Requires (Dev)

• phpunit/phpunit: ^9.2
• roave/security-advisories: dev-latest

MIT

• czachor

• symfony
• validator
• poland
• pwz

README

Version: 1.3

Pcackage is currently marked as deprecated. A new version is coming soon.

PHP library based on Symfony Validator Component to validate various medical identification numbers used in Poland.

Only algorithmical validation mostly based on a check digit. It does not query official medical registries to fetch any data or if a record (ID) exists at all.

Available validators

• Numer Prawa Wykonywania Zawodu Lekarza (PWZ) (Polish medical licence ID for physicians)

  <?php
  use Czachor\PolishIdValidators\Entities\PwzEntity;
  
  $id = new PwzEntity('5425740');

  Example: 5425740, total 7 digits:

  • check digit
  • 6 digits

  Source:

  • https://rejestr.nil.org.pl/
  • https://nil.org.pl/rejestry/centralny-rejestr-lekarzy/zasady-weryfikowania-nr-prawa-wykonywania-zawodu

• Numer Prawa Wykonywania Zawodu Farmaceuty (PWZF) (pharmacists ID)

  <?php
  use Czachor\PolishIdValidators\Entities\PwzfEntity;
  
  $id = new PwzfEntity('09014954');

  EAN-8 code, example: 09014954, total 8 digits:

  • 2-digits local district chamber (01 to 22)
  • 5-digits sequential number
  • check digit

  Source:

  • https://crf.rejestrymedyczne.csioz.gov.pl/
  • https://www.nia.org.pl/dat/magazyn/biuletyn_IV_07_2005.pdf

• Numer Prawa Wykonywania Zawodu Pielęgniarki/Położnej (PWZP) (nurses and midwives ID)

  <?php
  use Czachor\PolishIdValidators\Entities\PwzpEntity;
  
  $id = new PwzpEntity('0201234P');

  Example: 0201234P, total 8 chars: 7 digits and letter:

  • 2-digits ID of local District Chamber of Nurses and Midwives (01 to 45)
  • 5-digits sequential number
  • letter P or A

  Source:

  • https://nipip.pl/weryfikacja-pwz/
  • https://nipip.pl/uchwala-nr-320-vii-2018-nrpip-z-dnia-12-wrzesnia-2018-r-w-sprawie-trybu-postepowania-dotyczacego-stwierdzania-i-przyznawania-prawa-wykonywania-zawodu-pielegniarki-i-zawodu-poloznej-oraz-sposobu-prow/

• Numer Prawa Wykonywania Zawodu Diagnosty Laboratoryjnego (PWZDL) (laboratory diagnostician ID)

  <?php
  use Czachor\PolishIdValidators\Entities\PwzdlEntity;
  
  $id = new PwzdlEntity('3143');

  Example: 3143, PWZDL ID are simple sequential numbers, so there is very simple "is numeric" validation.

Requirements

PHP 7.2+.

Install

Via Composer

$ composer require czachor/polish-id-validators

Usage

All ID must be passed as strings.

Direct method

<?php
use Czachor\PolishIdValidators\Entities\PwzEntity;
use Czachor\PolishIdValidators\Validator;

$pwz_id = new PwzEntity('5425740'); // Polish medical licence ID
/** @var Symfony\Component\Validator\ConstraintViolationListInterface $obj_validator */
$violations = Validator::validate($pwz_id);

if ($violations->count() > 0) {
    foreach ($violations as $violation) {
        echo 'Error! ' . $violation->getMessage();
    }
} else {
    echo 'Valid!';
}

With Symfony Component:

<?php
use Czachor\PolishIdValidators\Entities\PwzEntity;
use Symfony\Component\Validator\Validation;

$pwz_id = new PwzEntity('5425740'); // Polish medical licence ID 
$validator = Validation::createValidatorBuilder()
    ->addMethodMapping('loadValidatorMetadata')
    ->getValidator();
$violations = $validator->validate($pwz_id);

// ...

Translation

Translation uses Symfony Translation Component.

Available languages:

• English (default) - en_US
• Polish - pl_PL

How to use:

<php
$violations = Validator::validate($pwz_id, 'pl_PL');

If your language is unsupported, you can add it manually:

<?php
$violations = Validator::validate($pwz_id, 'pt_BR', $path_to_your_php_resource_file);

Or if you want to use a different loader:

use Symfony\Component\Translation\Translator;
use Symfony\Component\Translation\Loader\ArrayLoader;
use Symfony\Component\Validator\Validation;
use Czachor\PolishIdValidators\Entities\PwzEntity;

$translator = new Translator('fr_FR');
$translator->addLoader('array', new ArrayLoader());
$translator->addResource('array', [
    'Hello World!' => 'Bonjour',
], 'fr_FR');

$validator = Validation::createValidatorBuilder()
    ->addMethodMapping('loadValidatorMetadata')
    ->setTranslator($translator)
    ->getValidator();

$pwz_id = new PwzEntity('5425740'); // Polish medical licence ID 
$violations = $validator->validate($pwz_id);
// ...

Todo

• More validators
• Annotations
• More translations

License

The MIT License (MIT).