README

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'),
        ],
    ];
}

::: warning 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. :::

API

Validation Rule

LaravelEnso\CnpValidator\Validators\Cnp

Public entry point:

• __invoke($attribute, $value, $fail)

The rule calls the internal validator and fails the field when the provided CNP is invalid.

Validator Helper

LaravelEnso\CnpValidator\Validators\Validator

Public methods:

• __construct(?string $cnp = null)
• fails(string $cnp): bool
• passes(): bool

Validation flow:

• numeric-only check
• 13-digit length check
• encoded date validation
• checksum validation

Depends On

Framework dependency:

• laravel/framework ↗

Contributions

are welcome. Pull requests are great, but issues are good too.

Thank you to all the people who already contributed to Enso!