README

Introduction

The Laravel-Validate package enhanced Laravel validation capabilities with custom rules and methods for simplified and efficient validation logic.
You can validate data more easily. The Laravel Validate has lots of rule classes for validation.
This package supports localization and can be used for most languages.
(If some language didn't support, you can create PR for new language)

AI Documentation

Requirements

• PHP >= 8.0
• Laravel >= 9.0

Installation

You can install the package with Composer.

composer require milwad/laravel-validate

Publish

If you want to publish a config file, you can run the following command on your terminal:

php artisan vendor:publish --tag="laravel-validate-config"

If you want to publish a lang file for a custom validation message, you can run this command in the terminal:

php artisan vendor:publish --tag="validate-lang-{$lang}"

You can replace $lang with your language name, for example:

php artisan vendor:publish --tag="validate-lang-en"

You can see the Support Languages section if you don't know the language's name.

Configurations

If you may use rules with a string like ValidPhone, you need to change the config option to true:

/*
 * If you want to use rules like 'required|ValidPhone' in your validations, you can change it to true.
 */
'using_container' => false,

If using_container is set to true, you might have rules like this:

'phone_number' => 'required|ValidPhone',

And ValidPhone would be a class that is resolved via the service container to check the validity of the phone number.

Usage

You can use Laravel-Validate Rules very simply. You can use the new keyword before the rule name.

use Milwad\LaravelValidate\Rules\ValidPhoneNumber;

return [
    'phone' => ['required', new ValidPhoneNumber()],
];

Rules

Support Languages

If a language is not supported, you can make issue to add it.
Also, you can make PR to add it.

• Arabic (ar)
• Azerbaijani (az)
• Bangla (bn)
• Catalan (ca)
• Dutch (nl)
• German (de)
• Greek (el)
• English (en)
• Spanish (es)
• Persian (fa)
• French (fr)
• Hindi (hi)
• Indonesian (id)
• Italian (It)
• Japanese (ja)
• Korean (ko)
• Kurdish Sorani (ku_so)
• Português Brasil (pt_BR)
• Russian (ru)
• Sinhala (si)
• Swedish (sv)
• Turkish (tr)
• Ukrainian (uk)
• Chinese (zh_CN)

Adding Custom Phone Country Validator

If you need to add a custom phone number validator for a specific country, follow the steps below.

1. Create Your Custom Validator Class

First, you need to create a custom validator class that implements the Milwad\LaravelValidate\Utils\CountryPhoneValidator contract. This contract ensures that your custom validator adheres to the required structure and functionality.

namespace App\Validators;

use Milwad\LaravelValidate\Utils\CountryPhoneValidator;

class CustomPhoneValidator implements CountryPhoneValidator
{
    /**
     * Validate the phone number for the custom country.
     */
    public function validate(string $phoneNumber): bool
    {
        // Implement the phone number validation logic for your country
        // Example: Check if the phone number matches a specific pattern
        return preg_match('/^\+1234\d{10}$/', $phoneNumber);
    }
}

2. Add the Validator to the Configuration File

Once you've created the custom validator class, add it to the configuration file (config/laravel-validate.php) under the 'phone-country' array.

For example, if you're adding a validator for the country XY:

'phone-country' => [
    // Existing validators...
    'XY' => \App\Validators\CustomPhoneValidator::class, // Custom country
],

This tells the system to use your custom validator for phone numbers from country XY.

3. Validation Usage

Once your custom validator is set up, you can use it in your application like any other validator:

return [
    'phone_ir' => [new ValidPhoneNumber('XY')],
];

License

• This package is created and modified by Milwad Khosravi for Laravel over more than 9 and has been released under the MIT License.

Contributing

This project exists thanks to all the people who contribute. CONTRIBUTING

Security

If you've found a security bug, please email milwad.dev@gmail.com instead of using the issue tracker.

Star History

Donate

If this package is helpful for you, you can buy a coffee for me :) ❤️

• Iraninan Gateway: https://daramet.com/milwad_khosravi
• Paypal Gateway: SOON
• MetaMask Wallet: 0xf208a562c5a93DEf8450b656c3dbc1d0a53BDE58