Phone Validator

Description

Phone Validator provides a configurable Laravel validation rule for phone numbers.

The package owns reusable phone validation for Laravel Enso applications, keeping phone-number rules, accepted-format metadata, and validation error text out of consuming projects. It ships with default Romanian phone formats and lets applications override both the validation regex and display masks through configuration.

This is a private Laravel Enso package distributed through GitLab.

Installation

Configure the private repository in the consuming application's composer.json:

{
    "repositories": [
        {
            "type": "git",
            "url": "git@git.xtelecom.ro:laravel-enso/phone-validator.git"
        }
    ]
}

Install the package:

composer require laravel-enso/phone-validator

No manual service provider registration is required. Laravel auto-discovers LaravelEnso\PhoneValidator\AppServiceProvider.

Publish the configuration when customization is needed:

php artisan vendor:publish --tag=phone-validator-config

The configuration is published to:

config/enso/phoneValidator.php

Publish the translations when message customization is needed:

php artisan vendor:publish --tag=phone-validator-lang

The translations are published to:

lang/vendor/phone-validator

Features

Provides a Laravel validation rule through LaravelEnso\PhoneValidator\Validators\Phone.
Uses Laravel's ValidationRule API.
Validates values through a configurable regular expression.
Exposes configured display masks for validation messages.
Ships with default Romanian phone formats.
Ships with an English validation message.
Supports application-level configuration and translation publishing.
Exposes a reusable low-level validator helper through LaravelEnso\PhoneValidator\Validators\Validator.

Usage

Use the rule in a form request or validator instance:

use LaravelEnso\PhoneValidator\Validators\Phone;

public function rules(): array
{
    return [
        'phone' => ['required', new Phone()],
    ];
}

The rule is strict. It does not normalize local numbers, spaces, punctuation, or missing country prefixes before validation.

The default configuration accepts values such as:

+40792802305
+40211234567
+40311234567

It rejects local-only values such as 0792802305.

Configuration

Default configuration:

return [
    'regex' => '/^\+4(07|02|03)[0-9]{8}$/',
    'masks' => ['+407XXXXXXXX', '+402XXXXXXXX', '+403XXXXXXXX'],
];

The regex controls validation. Masks are used only for the validation message.

To customize accepted values, publish the configuration and update regex:

return [
    'regex' => '/^00[0-9]{4}$/',
    'masks' => ['00XXXX'],
];

Translations

The package ships with an English validation message:

return [
    'phone' => 'The :attribute must be a valid phone number. Accepted formats: :formats.',
];

The :formats placeholder is generated from the configured masks.

The rule translates the message through Laravel's validation failure API:

$fail('phone-validator::validation.phone')->translate([
    'formats' => $this->masks(),
]);

Publish the translations when the consuming application needs to customize the text without changing the package:

php artisan vendor:publish --tag=phone-validator-lang

Testing

Run the package tests with:

vendor/bin/phpunit

The test suite covers accepted formats, invalid values, default messages, translation overrides, configuration overrides, default configuration loading, and low-level validator helper behavior.