CNP Validator

Description

CNP Validator provides a dedicated Laravel validation rule for Romanian personal numeric codes.

The package exposes a lightweight invokable validation rule that checks whether a value is numeric, has the expected 13-digit length, contains a valid encoded birth date, and matches the official CNP checksum.

It works independently of the Enso ecosystem and can be used in any Laravel application that relies on Laravel's validator.

Installation

Install the package:

composer require laravel-enso/cnp-validator

No additional service provider registration is required.

Features

Provides an invokable Laravel validation rule through LaravelEnso\CnpValidator\Validators\Cnp.
Validates that the CNP contains only numeric digits.
Validates the required 13-character length.
Validates the encoded date portion of the CNP.
Validates the checksum using the official control hash table.
Exposes a reusable low-level validator helper through LaravelEnso\CnpValidator\Validators\Validator.

Usage

Use the rule in a form request or validator instance:

use Illuminate\Support\Facades\Validator;
use LaravelEnso\CnpValidator\Validators\Cnp;

$validator = Validator::make(
    ['cnp' => '1800219081826'],
    ['cnp' => ['nullable', new Cnp()]],
);

Example in a form request:

use Illuminate\Validation\Rule;
use LaravelEnso\CnpValidator\Validators\Cnp;

public function rules(): array
{
    return [
        'cnp' => [
            'nullable',
            'max:13',
            new Cnp(),
            Rule::unique('users', 'nin'),
        ],
    ];
}

Note

The package reports failed validation with the Invalid message.

If you want a localized or more specific validation message, map that message in your validation language files or customize it in the consuming validator layer.