Download the PHP package infinitypaul/php-validator without Composer
On this page you can find all versions of the php package infinitypaul/php-validator. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download infinitypaul/php-validator
More information about infinitypaul/php-validator
Files in infinitypaul/php-validator
Package php-validator
Short Description A validator featuring rule objects, string rule mapping, wildcard validation and more
License MIT
Homepage https://github.com/infinitypaul/php-validator
Informations about the package php-validator
Flexible PHP Validation Class
This package can validate values according to flexible rules.
It can take an associative array of values and a set of rules and validate the values to verify if they comply with the rules.
The package can validate the values according to a given list of common rules, as well validate the values with custom rules implemented by external validation classes.
Installation
You can install the package via composer:
Basic Usage
Writing The Validation Logic
We pass the field we intend to validate into the Validator
class
Validation Rules
we pass the desired validation rules into the setRules()
method. Again, if the validation fails, the proper response will save in the ErrorBag. If the validation passes, our validate method returns a true statement.
Displaying The Validation Errors
So, what if the incoming parameters do not pass the given validation rules? The errors will be able in the getErrors()
method like the above
Validation Error Check
You may also use the validate()
method to quickly check if validation error messages exist. It returns boolean:
Customizing The Error Key
If you can enter full_name as the key to be validated and required is set, your error message comes out in this format full_name is required
You can customize the full_name
with the setAliases
method.
Validating Arrays
Validating array doesn't have to be a pain. You may use "dot notation" to validate attributes within an array. For example, if the incoming request contains an array field, you may validate it like so:
You may also validate each element of an array. For example, to validate that each e-mail in a given array input field is unique, you may do the following:
Custom Validation Rules
You may wish to specify some of your own rules. One method of registering custom validation rules is extending the Rule Class
Once the custom rule class has been created, we are ready to define its behavior. A rule object contains two methods: passes and message. The passes method receives the field, value, and data, and should return true or false depending on whether the value is valid or not. The message method should return the validation error message that should be used when validation fails:
Once the rule has been defined, you may attach it to a validator by passing an instance of the rule object with your other validation rules:
Available Validation Rules
Below is a list of all available validation rules and their function
- Required
- Max
- RequiredWith
- Optional
- Between
- Image
- Same
- Confirmed
- Numeric
Required :
The field under validation must be present in the input data and not empty.
Email :
The field under validation must be formatted as an e-mail address
Max :
The field under validation must be less than or equal to a maximum value
RequiredWith :
The field under validation must be present and not empty only if all of the other specified fields are present.
Between :
The field under validation must have a size between the given min and max
Optional :
The field under validation may be null. This is particularly useful when validating primitive such as strings and integers that can contain null values.
Image :
The file under validation must be an image (jpeg, png, bmp, gif, svg, or webp), the image tmp_name
is what you need to pass to the validator
Same :
The given field must match the field under validation.
Confirmed :
The field under validation must have a matching field of foo_confirmation. For example, if the field under validation is password, a matching password_confirmation field must be present in the input.
Numeric :
The field under validation must be numeric.
Note
I intend to keep adding more rules to the package but If you have any additional rules you will like me to add to this, you can reach out to me or open an issue in that regard.
How can I thank you?
Why not star the github repo? I'd love the attention! Why not share the link for this repository on Twitter or HackerNews? Spread the word!
Don't forget to follow me on twitter || or on medium
Thanks! Edward Paul.
Changelog
Please see CHANGELOG for more information what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Bug & Features
If you have spotted any bugs, or would like to request additional features from the library, please file an issue via the Issue Tracker on the project's Github page: https://github.com/infinitypaul/php-validator/issues.
License
The MIT License (MIT). Please see License File for more information.