Download the PHP package gajus/vlad without Composer
On this page you can find all versions of the php package gajus/vlad. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Package vlad
Short Description Input validation library, that has inbuilt error messages that are translatable, validators that are easy to extend, and that has easy to understand test declaration syntax.
License BSD-3-Clause
Homepage https://github.com/gajus/vlad
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package vlad
Vlad
Input validation library, that has inbuilt error messages that are translatable, validators that are easy to extend, and that has easy to understand test declaration syntax.
Succinct Test Declaration
Test is composed of assertions about the input.
Limit the Assessment Scope
Note that assertions are done against selector name, not the actual value. You can limit test to specific assertions at the time of the assessment:
Extendable Validation Rules
Vlad has inbuilt validators. It is easy to write custom validators. You can request new validators to be added to the core package. Validators benefit from the translator interface.
Vlad does not encourage inline boolean validation expressions.
Inbuilt Validation Rules
| Validator | Description |
|---|---|
| String | Validate that input is a string. |
| Regex | Validate that input is matched using a regular expression. |
| Date | Validates that string can be parsed using a date format. |
| RangeMinInclusive | Validate that a numeric input is at least of the given size (inclusive). |
| RangeMinExclusive | Validate that a numeric input is at least of the given size (exclusive). |
| RangeMaxInclusive | Validate that a numeric input is at most of the given size (inclusive). |
| RangeMaxExclusive | Validate that a numeric input is at most of the given size (exclusive). |
| NotEmpty | Validate that input value is not empty. |
| Length | Validate that input string representation is of a specific length. |
| Integer | Validate that input is an integer. |
| LengthMin | Validate that input string representation is not shorter than the specified length. |
| LengthMax | Validate that input string representation is not longer than the specified length. |
| In | Validate that input value is in the haystack. |
| Validate that input value is syntactically valid email address. |
Writing a Custom Validator
Each validator is a class that extends Gajus\Vlad\Validator. Validators that are not part of the Vlad package must be under a namespace.
In the test declaration, custom validator is referred to using the full (namespaced) class name.
Multilingual
Translator allows to overwrite default error messages and give input names.
In addition to the provided (below) use cases of the translator, you can extend Gajus\Vlad\Translator with your own functionality (e.g. importing translations from a file or database).
Input name
In most cases, you do not need to provide input name at all. Vlad will derive English name from the selector, e.g. foo[bar_tar_id] will come out as "Foo Bar Tar".
You can translate input names.
The above will produce the following error message:
Bar Tar is empty.
Validator Message
Validators have inbuilt English error messages. You can overwrite them like this:
Foo Bar cannot be left empty.
Assertion Error Message
Individual assertions can overwrite the error messages.
Installation
Vlad uses Composer to install and update:
Todo
- Documentation.
- Add URL validator. This should consider that URL does not necessarily include protocol and that those that do include, e.g. ftp:// might not necessarily be expected URLs.
- Improve email validator. Zend validator includes useful additions (MX check, host name validator, etc) https://github.com/zendframework/zf2/blob/master/library/Zend/Validator/EmailAddress.php.
Alternatives
- https://github.com/project-melody/validator
- https://github.com/zendframework/zf2/tree/master/library/Zend/Validator
- https://github.com/Respect/Validation
- https://github.com/Wixel/GUMP
- https://github.com/vlucas/valitron
- https://github.com/Dachande663/PHP-Validation
- https://github.com/fuelphp/validation
- https://github.com/smgt/inspector
