https://github.com/milwad-dev/laravel-validate
Help to write easy & faster advance validation for Laravel
https://github.com/milwad-dev/laravel-validate
advance-validation larave-package laravel laravel-eloquent-validation laravel-rule laravel-validate laravel-validate-package laravel-validate-rule laravel-validation laravel-validation-library localization php rule validate validation validation-rule
Last synced: 18 days ago
JSON representation
Help to write easy & faster advance validation for Laravel
- Host: GitHub
- URL: https://github.com/milwad-dev/laravel-validate
- Owner: milwad-dev
- License: mit
- Created: 2022-07-16T18:21:06.000Z (almost 3 years ago)
- Default Branch: 1.x
- Last Pushed: 2024-04-10T19:43:42.000Z (about 1 year ago)
- Last Synced: 2024-04-10T22:51:15.328Z (about 1 year ago)
- Topics: advance-validation, larave-package, laravel, laravel-eloquent-validation, laravel-rule, laravel-validate, laravel-validate-package, laravel-validate-rule, laravel-validation, laravel-validation-library, localization, php, rule, validate, validation, validation-rule
- Language: PHP
- Homepage: https://packagist.org/packages/milwad/laravel-validate
- Size: 402 KB
- Stars: 429
- Watchers: 11
- Forks: 39
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Laravel Validate
[](https://packagist.org/packages/milwad/laravel-validate)
[](https://packagist.org/packages/milwad/laravel-validate)
[](https://packagist.org/packages/milwad/laravel-validate)
[](https://packagist.org/packages/milwad/laravel-validate)
[](https://github.com/milwad-dev/laravel-validate/actions/workflows/run-tests.yml)
[](https://scrutinizer-ci.com/g/milwad-dev/laravel-validate)
[](https://github.com/milwad-dev/laravel-validate/actions/workflows/imports.yml)
***
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, `Laravel Validate` has lots of rule classes for validation.
This package supports localization and can be used for most of the languages.
(If some language didn't support, you can PR for new language)
# Requirements
***
- ```PHP >= 8.0```
- ```Laravel >= 9.0```
| GitHub | L6 | L7 | L8 | L9 | L10 | L11 | L12 |
|--------|--------------------|--------------------|--------------------|--------------------|--------------------|--------------------|--------------------|
| 1.5 | :white_check_mark: | :white_check_mark: | :white_check_mark: | :white_check_mark: | :x: | :x: | :x: |
| 1.6 | :x: | :x: | :x: | :white_check_mark: | :white_check_mark: | :x: | :x: |
| 1.7 | :x: | :x: | :x: | :white_check_mark: | :white_check_mark: | :x: | :x: |
| 1.8 | :x: | :x: | :x: | :white_check_mark: | :white_check_mark: | :white_check_mark: | :x: |
| 1.9 | :x: | :x: | :x: | :white_check_mark: | :white_check_mark: | :white_check_mark: | :white_check_mark: |
# Installation
You can install the package with Composer.
```bash
composer require milwad/laravel-validate
```
# Publish
If you want to publish config file, you can run below command on your terminal:
```shell
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:
```shell
php artisan vendor:publish --tag="validate-lang-{$lang}"
```
You can replace `$lang` with your language name, for example:
```shell
php artisan vendor:publish --tag="validate-lang-en"
```
You can see the [Support Languages](#support-languages) section if you don't know the language's name.
# Configurations
If you may use rules with string like `ValidPhone`, you need to change the config option to `true`:
```php
/*
* 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:
```php
'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.
```php
use Milwad\LaravelValidate\Rules\ValidPhoneNumber;
return [
'phone' => ['required', new ValidPhoneNumber()],
];
```
# Rules
| # | Rule name | Usage |
|----|----------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 1 | [ValidBase64](https://github.com/milwad-dev/laravel-validate/blob/1.x/docs/1.x/valid-base64.md) | Validate base64 for ex (bWlsd2Fk) |
| 2 | [ValidBitcoinAddress](https://github.com/milwad-dev/laravel-validate/blob/1.x/docs/1.x/valid-bitcoin-address.md) | Validate bitcoin address for ex (1KFHE7w8BhaENAswwryaoccDb6qcT6DbYY) |
| 3 | [ValidCamelCase](https://github.com/milwad-dev/laravel-validate/blob/1.x/docs/1.x/valid-camel-case.md) | Validate camel case for ex (milwadDev) |
| 4 | [ValidCapitalCharWithNumber](https://github.com/milwad-dev/laravel-validate/blob/1.x/docs/1.x/valid-capital-char-with-number.md) | Validate String for ex (MILWAD-84) |
| 5 | [ValidCarNumber](https://github.com/milwad-dev/laravel-validate/blob/1.x/docs/1.x/valid-car-number.md) | Validate car number for ex (KA01AB1234) |
| 6 | [ValidCartNumberIran](https://github.com/milwad-dev/laravel-validate/blob/1.x/docs/1.x/valid-cart-number-iran.md) | Validate cart number for ex (1234123412341234) |
| 7 | [ValidCountry](https://github.com/milwad-dev/laravel-validate/blob/1.x/docs/1.x/valid-country.md) | Validate country name for ex (United Arab Emirates) |
| 8 | [ValidCreditCard](https://github.com/milwad-dev/laravel-validate/blob/1.x/docs/1.x/valid-credit-card.md) | Validate credit card for ex (4111111111111111) |
| 9 | [ValidDiscordUsername](https://github.com/milwad-dev/laravel-validate/blob/1.x/docs/1.x/valid-discord-username.md) | Validate username discord for ex (Milwad#2134) |
| 10 | [ValidDomain](https://github.com/milwad-dev/laravel-validate/blob/1.x/docs/1.x/valid-domain.md) | Validate domain name for ex (github.com) |
| 11 | [ValidDuplicate](https://github.com/milwad-dev/laravel-validate/blob/1.x/docs/1.x/valid-duplicate.md) | Validate duplicate string, numbers for ex (1123456) |
| 12 | [ValidDuplicateCharacter](https://github.com/milwad-dev/laravel-validate/blob/1.x/docs/1.x/valid-duplicate-character.md) | Validate duplicate characters for ex (1,2,3,4,5,6,7,8,9) |
| 13 | [ValidEvenNumber](https://github.com/milwad-dev/laravel-validate/blob/1.x/docs/1.x/valid-even-number.md) | Validate number is even for ex (1024) |
| 14 | [ValidHashtag](https://github.com/milwad-dev/laravel-validate/blob/1.x/docs/1.x/valid-hashtag.md) | Validate hashtag for ex (#milwad) |
| 15 | [ValidHexColor](https://github.com/milwad-dev/laravel-validate/blob/1.x/docs/1.x/valid-hex-color.md) | Validate hex color for ex (#fcba03) |
| 16 | [ValidHtmlTag](https://github.com/milwad-dev/laravel-validate/blob/1.x/docs/1.x/valid-html-tag.md) | Validate html tags for ex (`
`) |
| 17 | [ValidIban](https://github.com/milwad-dev/laravel-validate/blob/1.x/docs/1.x/valid-iban.md) | Validate IBAN ex (IR062960000000100324200001) |
| 18 | [ValidImei](https://github.com/milwad-dev/laravel-validate/blob/1.x/docs/1.x/valid-imei.md) | Validate imei phone for ex (354809104295874) |
| 19 | [ValidIpAddressIPV4](https://github.com/milwad-dev/laravel-validate/blob/1.x/docs/1.x/valid-ip-address-ipv4.md) | Validate ip address IPV4 for ex (129.144.50.56) |
| 20 | [ValidIpAddressIPV6](https://github.com/milwad-dev/laravel-validate/blob/1.x/docs/1.x/valid-ip-address-ipv6.md) | Validate ip address IPV6 for ex (2001:db8:3333:4444:5555:6666:7777:8888) |
| 21 | [ValidIranPostalCode](https://github.com/milwad-dev/laravel-validate/blob/1.x/docs/1.x/valid-iran-postal-code.md) | Validate Iran postal code ex (3354355599) |
| 22 | [ValidJalaliDate](https://github.com/milwad-dev/laravel-validate/blob/1.x/docs/1.x/valid-jalali-date.md) | Validate jalali date for ex (1384/8/25) |
| 23 | [ValidJwt](https://github.com/milwad-dev/laravel-validate/blob/1.x/docs/1.x/valid-jwt.md) | Validate jwt for ex (eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjEyMzQ1Njc4OTAiLCJuYW1lIjoiSm9obiBEb2UiLCJhZG1pbiI6dHJ1ZSwiZXhwIjoxNTgyNjE2MDA1fQ.umEYVDP_kZJGCI3tkU9dmq7CIumEU8Zvftc-klp-334) |
| 24 | [ValidKebabCase](https://github.com/milwad-dev/laravel-validate/blob/1.x/docs/1.x/valid-kebab-case.md) | Validate kebab case for ex (milwad-dev) |
| 25 | [ValidNameDaysWeek](https://github.com/milwad-dev/laravel-validate/blob/1.x/docs/1.x/valid-name-days-week.md) | Validate day week for ex (monday) |
| 26 | [ValidNationalCard](https://github.com/milwad-dev/laravel-validate/blob/1.x/docs/1.x/valid-national-card.md) | Validate national card for ex (015016437) |
| 27 | [ValidOddNumber](https://github.com/milwad-dev/laravel-validate/blob/1.x/docs/1.x/valid-odd-number.md) | Validate number is odd for ex (4321) |
| 28 | [ValidPascalCase](https://github.com/milwad-dev/laravel-validate/blob/1.x/docs/1.x/valid-pascal-case.md) | Validate pascal case for ex (MilwadDev) |
| 29 | [ValidPattern](https://github.com/milwad-dev/laravel-validate/blob/1.x/docs/1.x/valid-pattern.md) | Validate texts with specific pattern 🔥 for ex (4444-4444-4444) |
| 30 | [ValidPhoneNumber](https://github.com/milwad-dev/laravel-validate/blob/1.x/docs/1.x/valid-phone-number.md) | Validate phone number for ex (09366000000) |
| 31 | [ValidPort](https://github.com/milwad-dev/laravel-validate/blob/1.x/docs/1.x/valid-port.md) | Validate port value for ex (8080) |
| 32 | [ValidSlashEndOfString](https://github.com/milwad-dev/laravel-validate/blob/1.x/docs/1.x/valid-slash-end-of-string.md) | Validate write slash at the string for ex (milwad/) |
| 33 | [ValidSlug](https://github.com/milwad-dev/laravel-validate/blob/1.x/docs/1.x/valid-slug.md) | Validate slug for ex (milwad-dev) |
| 34 | [ValidSnakeCase](https://github.com/milwad-dev/laravel-validate/blob/1.x/docs/1.x/valid-snake-case.md) | Validate snake case for ex (milwad_dev) |
| 35 | [ValidStrongPassword](https://github.com/milwad-dev/laravel-validate/blob/1.x/docs/1.x/valid-strong-password.md) | Validate password for ex (Milwad123!) |
| 36 | [ValidUlid](https://github.com/milwad-dev/laravel-validate/blob/1.x/docs/1.x/valid-ulid.md) | Validate ulid for ex (01ARZ3NDEKTSV4RRFFQ69G5FAV) |
| 37 | [ValidUrl](https://github.com/milwad-dev/laravel-validate/blob/1.x/docs/1.x/valid-url.md) | Validate url for ex (https://www.google.com) |
| 38 | [ValidUsername](https://github.com/milwad-dev/laravel-validate/blob/1.x/docs/1.x/valid-username.md) | Validate username for ex (milwad) |
| 39 | [ValidUuid](https://github.com/milwad-dev/laravel-validate/blob/1.x/docs/1.x/valid-uuid.md) | Validate uuid for ex (123e4567-e89b-12d3-a456-426655440000) |
| 40 | [ValidVatId](https://github.com/milwad-dev/laravel-validate/blob/1.x/docs/1.x/valid-vatid.md) | Validate european VAT ID ex (EL123456789123) |
# Support Languages
If a language is not supported, you can make issue to add it.
Also, you can make PR to add it.
- [x] Arabic (ar)
- [x] Azerbaijani (az)
- [x] Bangla (bn)
- [x] Catalan (ca)
- [x] Dutch (nl)
- [x] German (de)
- [x] Greek (el)
- [x] English (en)
- [x] Spanish (es)
- [x] Persian (fa)
- [x] French (fr)
- [x] Hindi (hi)
- [x] Indonesian (id)
- [x] Italian (It)
- [x] Japanese (ja)
- [x] Korean (ko)
- [x] Kurdish Sorani (ku_so)
- [x] Português Brasil (pt_BR)
- [x] Russian (ru)
- [x] Sinhala (si)
- [x] Swedish (sv)
- [x] Turkish (tr)
- [x] Ukrainian (uk)
- [x] 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.
```php
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`:
```php
'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:
```php
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](https://github.com/milwad-dev/laravel-validate/graphs/contributors)
# Security
If you've found a security bug, please email [[email protected]](mailto:[email protected]) instead of using the issue tracker.
# Star History
[](https://star-history.com/#milwad-dev/laravel-validate&Date)
# 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`