README

A Laravel validation rule for validating a person's first and last name. Unicode-safe and supports names from any language or culture.

Installation

composer require webmintydotcom/laravel-person-name

The service provider is auto-discovered by Laravel.

Usage

Basic Usage

use Webminty\PersonName\Rules\ValidPersonName;

$request->validate([
    'first_name' => ['required', new ValidPersonName],
    'last_name' => ['required', new ValidPersonName],
]);

Custom Minimum Length

The default minimum length is 2 characters. You can change it:

$request->validate([
    'first_name' => ['required', new ValidPersonName(minLength: 1)],
    'last_name' => ['required', new ValidPersonName(minLength: 3)],
]);

In a Form Request

use Webminty\PersonName\Rules\ValidPersonName;

class StoreUserRequest extends FormRequest
{
    public function rules(): array
    {
        return [
            'first_name' => ['required', new ValidPersonName],
            'last_name' => ['required', new ValidPersonName],
        ];
    }
}

What It Validates

The rule checks that a name:

• Is a string
• Meets the minimum length (default: 2)
• Starts and ends with a letter
• Only contains letters, spaces, hyphens, apostrophes, and periods

Valid Names

Invalid Names

Error Messages

The package includes English translations out of the box:

• The :attribute must be a string.
• The :attribute must be at least :min characters.
• The :attribute may only contain letters, spaces, hyphens, apostrophes, and periods.

Customizing Messages

Publish the translations to customize them:

php artisan vendor:publish --tag=person-name-translations

Or override them inline:

$request->validate(
    ['first_name' => ['required', new ValidPersonName]],
    ['first_name.Webminty\PersonName\Rules\ValidPersonName' => 'Please enter a valid first name.'],
);

Requirements

• PHP 8.2+
• Laravel 11, 12, or 13

License

MIT

Thank you

Webminty team