nepada/birth-number-doctrine

Czech birth number type for Doctrine.

v1.2.0 2023-09-28 18:57 UTC

Requires

• php: >=8.1.0 <8.4
• doctrine/dbal: ^2.6@dev || ^3.0@dev
• nepada/birth-number: ^1.0@dev

Requires (Dev)

• composer-runtime-api: ^2.0
• composer/semver: 3.4.0
• mockery/mockery: 1.6.6
• nepada/coding-standard: 7.13.0
• nepada/phpstan-nette-tester: 1.1.0
• nette/tester: 2.5.1
• php-parallel-lint/php-parallel-lint: 1.3.2
• phpstan/phpstan: 1.10.32
• phpstan/phpstan-mockery: 1.1.1
• phpstan/phpstan-nette: 1.2.9
• phpstan/phpstan-strict-rules: 1.5.1
• shipmonk/phpstan-rules: 2.7.0
• spaze/phpstan-disallowed-calls: 2.16.0

BSD-3-Clause

• Petr Morávek

• doctrine
• nette
• Value Object
• birth number

README

Installation

Via Composer:

$ composer require nepada/birth-number-doctrine

Register the type in your bootstrap:

\Doctrine\DBAL\Types\Type::addType(
    \Nepada\BirthNumberDoctrine\BirthNumberType::NAME,
    \Nepada\BirthNumberDoctrine\BirthNumberType::class
);

In Nette with nettrine/dbal integration, you can register the types in your configuration:

dbal:
    connection:
        types:
            Nepada\BirthNumber\BirthNumber: Nepada\BirthNumberDoctrine\BirthNumberType

Usage

BirthNumberType maps database value to Birth number value object (see nepada/birth-number for further details) and back. The Birth number is stored as fixed string without the slash (e.g. 0001010009).

Example usage in the entity:

use Doctrine\ORM\Mapping as ORM;
use Nepada\BirthNumber\BirthNumber;

/**
 * @ORM\Entity
 */
class Person
{

    /** @ORM\Column(type=BirthNumber::class, nullable=false) */
    private BirthNumber $birthNumber;

    public function getBirthNumber(): BirthNumber
    {
        return $this->birthNumber;
    }

}

Example usage in query builder:

$result = $repository->createQueryBuilder('foo')
    ->select('foo')
    ->where('foo.birthNumber = :birthNumber')
     // the parameter value is automatically normalized to '0001010009'
    ->setParameter('birthNumber', '000101 / 0009', BirthNumberType::NAME)
    ->getQuery()
    ->getResult();