Download the PHP package joshmoody/validation without Composer
On this page you can find all versions of the php package joshmoody/validation. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package validation
Validation Library
Simple input validation.
DEPRECATED!
This repository will no longer be updated. I've forked the project in werx/validation and will maintain the package there.
werx/validation 1.0.0 is identical to joshmoody/validation 1.0.0 except the namespace has changed.
Usage
There are two components to this library. A set of validation methods and an input validation engine.
Validators
The Validator class can be used to quickly validate a single piece of input.
The following validators are available. Each validator returns a bool. true
= passed validation, false
= failed validation.
Validation Engine
The Validation Engine is used to validate a set of data against a set of rules.
Usage
First, get an instance of the Validation Engine:
Then add rules:
Parameters
- Form input name / array key of the element you are validating
- User friendly label for the element
- Pipe-delimited list of rules
- Each rule corresponds to a method name from the Validator class
- If the method accepts arguments, the args should be in square brackets after the rule name
- Example:
minlength[2]
- Exception: methods which accept an array as parameter should be in curly brackets after the rule name.
- Example:
inlist{red,white,blue}
- Example:
- Example:
- Except for the
required
validator, all validators will return true if the input is empty.- In other words,
minlength[2]
will only actually fire if you also add arequired
rule.
- In other words,
Now you can get a validation result.
Closures
In addition to predefined validation methods from the Validator
class, you can also use closures to create custom validation methods.
Three values will be passed to your closure:
- The full data set being validated.
- The id of the element being validated.
- The label for the element being validated.
The closure is expected to return an array.
- The first element of the array should be the validation result (
bool
). - The second element of the array should be an error message to display if validation failed.
- If validation passed, message may be null.
Rulesets
What if you want to save groups of rules instead of adding each rule individually every time you want to validate them? We've got you covered.
Create a new class that extends joshmoody\Validation\Ruleset
and add your rules in the constructor.
Then when you are ready to validate this group of rules:
Utility Methods
There are a couple utilities to make dealing with validation results easier.
getErrorSummary()
Returns a simple array containing a list of validation error messages.
getErrorSummaryFormatted()
Returns the error summary formatted as an html unordered list (<ul>
).
getErrorFields()
Returns list of fields that had an error. Useful if you want to apply some decoration to your form indicating which fields had a validation errors.
getRequiredFields()
Once you've added your rules, you can get back a list of required fields. This is useful when you want to indicate on your form which fields must be completed.
addCustomMessage()
Allows you to set custom error messages.
When displaying the error messages, {name}
will be replaced with the name of the field being validated. The rest of the field
is parsed with sprintf()
so that parameters like minlength
can be placed in the returned error message.
Examples:
Installation
Installation of this package is easy with Composer. If you aren't familiar with the Composer Dependency Manager for PHP, you should read this first.
If you don't already have Composer installed (either globally or in your project), you can install it like this:
$ curl -sS https://getcomposer.org/installer | php
Create a file named composer.json somewhere in your project with the following content:
Contributing
Unit Testing
Coding Standards
This library uses PHP_CodeSniffer to ensure coding standards are followed.
I have adopted the PHP FIG PSR-2 Coding Standard EXCEPT for the tabs vs spaces for indentation rule. PSR-2 says 4 spaces. I use tabs. No discussion.
To support indenting with tabs, I've defined a custom PSR-2 ruleset that extends the standard PSR-2 ruleset used by PHP_CodeSniffer. You can find this ruleset in the root of this project at PSR2Tabs.xml
Executing the codesniffer command from the root of this project to run the sniffer using these custom rules.