Download the PHP package web-complete/form without Composer
On this page you can find all versions of the php package web-complete/form. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
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 form
Form model
Flexible filtration and validation server side Form Model like in Yii2.
The library has no dependencies and can be easily used with any frameworks or code.
Installation
Usage
To use the Form, you need to create a class which extend AbstractForm and implement abstract methods: rules () and filters (). In the primitive case, they can return empty arrays.
Filters (filtration rules) is an array of the following format:
where:
field - field name or field path (dot separated) or array of fields
filter - filter name. It can be a string or callable function. The Form will check method availability in the own object and if not exists then in filter objects array (filtersObject) in case of string. The filter will be called with arguments: $value, $params (parameters from the filtration rules), $form (current from object) and will return the filtered value.
params - array of parameters will be passed to the filter. The requirement depends on the called filter.
Rules (validation rules) is an array of the following format:
where:
field - field name or field path (dot separated) or array of fields
validator - validator name. It can be a string or callable function. It can be a string or callable function. The Form will check method availability in the own object and if not exists then in validator objects array (validatorsObject) in case of string. The validator will be called with arguments: $value and $params (parameters from the filtration rules) and will return boolean.
params - array of parameters will be passed to the filter. The requirement depends on the called filter.
message - Message in case of error. Returns "error" by default or value from overridden the $defaultError property.
If the data field does not have any filtering or validation rules, it will be deleted. However, if the field is necessary, but does not require filtering and validation, you can specify its security by adding it to the rules rules without additional arguments:
The form has a built-in validator required, which checks that this field is not empty. The other validators will only be applied to non-empty fields.
The class constructor takes the following arguments:
rules - will be merged with rules() (optional)
filters - will be merged with filters() (optional)
validatorsObject - object with validation methods (optional)
filtersObject - object with filtration methods (optional)
The form API provides the following methods:
validate() : - validate data
setData($data) - filter and set form data
getData() - get form data
setValue($field, $value, $filter = true) - filter (by default) and set form field value
getValue($field) - get form field value
addError($field, $error) - add an error for field
hasErrors($field = null) - check for errors in the form or field
getErrors($field = null) - get form or field errors
getFirstErrors() - get the first errors of all form fields
resetErrors() - reset form errors
This library has classes Validators and Filters which contains the most commonly used filters and validators and FastForm class form simple forms.
Filters
Filters supplied with the library (can be used independently):trim - trim spaces (arguments: charlist, left, right)
escape - htmlspecialchars
capitalize - transform string to lowercase and capitalize first char
lowercase - transform string to lowercase
uppercase - transform string to uppercase
replace - replace substring (optional arguments: pattern (string or regular expression), to)
stripTags - strip html-tags
stripJs - strip js
For more information, see the Filters class annotations
Validators
Validators supplied with the library (can be used independently):equals - comparison with other value (arguments: value, not (check inequality in case of true))
compare - comparison with other value (arguments: field (The third argument is the Form object), not (check inequality in case of true))
email - e-mail
number - validate if numeric (optional arguments: min, max)
string - validate if string (optional arguments: min, max - string length)
regex - regular expression (arguments: pattern)
For more information, see the Validators class annotations
Examples
Filtering and validation rules:
Form usage:
Fast Form usage:
Custom abstract form creation with default rules:
