Cz Bank Account Validator Bundle Laravel Package

ebrana/cz-bank-account-validator-bundle

Symfony bundle providing a PHP attribute validation constraint for Czech bank account numbers (e.g., prefix-number/bankcode). Works on full string properties or computed methods with separate parts, supports custom error paths/messages, and allows custom bank code providers via service decoration.

Bundle for czech account number validation

Inspired by https://gist.github.com/malja/4fbe9b69878fc81dd2dd77c57fc059a9 that is enough if you just need a simple script.

This bundle adds Symfony validation constraint via PHP Attribute

Usage

Over property, that contains full number as string (i.e. xxx-xxxxxxx/xxxx)

use \Ebrana\CzBankAccountValidatorBundle\Validator\AccountNumberValid;

class Foo {
    #[AccountNumberValid]
    public ?string $accountNumber = null;
}

or if your class have parts separated, you can call it over method

use \Ebrana\CzBankAccountValidatorBundle\Validator\AccountNumberValid;

class Foo {
    public ?string $prefix = null;
    public string $accountNumber;
    public string $bankCode;
    //...
    #[AccountNumberValid(bankCodePath: 'bankCode', prefixPath: 'prefix')]
    public function getAccountNumber(): string
    {   
        $number = $this->accountNumber . '/' . $this->bankCode;
        if (null !== $this->prefix) {
            $number = $this->prefix . '-' . $number;
        }        
        
        return $number;
    }
    // ... 
}

Constraint options

You can specify path for specific errors in your constraint (see 2nd example) and also specify your custom messages.

Bank codes provider

We are using static list of current bank codes. But you can use custom logic to get the most up to date version from https://www.cnb.cz/cs/platebni-styk/ucty-kody-bank/ .

Just use decorator and implement your custom logic