Download the PHP package dbeurive/input without Composer
On this page you can find all versions of the php package dbeurive/input. 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 input
Description
This package is an implementation of a simple inputs' manager.
Inputs validation is a common task. This process often involves two steps :
- First, we validate each input in isolation to the others.
- Then, if all inputs are individually valid, we validate the set of inputs in relation to the others.
For example, let’s consider the validation of a register form.
- Some fields are « standalone ». This is the case, for example, for the first name. The validity of the entered value does not depend on another field’s value.
- Other fields, however, cannot be validated in isolation to the others. Typically, this is the case, for the « passwords » fields. Often, a register form asks you to confirm a password. Thus, you have two input fields for the password, and the values of these fields must be identical.
This package implements this simple 2 steps validation process.
- First, you specify each input. These specifications will be used to validate each input in isolation to the others. A specification contains the following information : what is the input’s name ? Is the input mandatory ? Can the input’s value be null ? Does the input need a special validator ?
- Then, you regroup the previously created specifications into a set of specifications. You may assign to the specifications’ set a global validator that will be used to validate all entries in relations to the others. Please note that this optional validator is executed if all inputs are valid (according to their respective specifications) in isolation to the others.
Inputs' specifications are instances of
dbeurive\Input\Specification. A specifications' set is an instance ofdbeurive\Input\SpecificationsSet.
At this point, all inputs’ individual validity rules are defined. And an optional global validator that ensures a coherence between inputs’ values is specified. You can submit a set of inputs' values to the specifications’ set.
Installation
From the command line:
composer require dbeurive/input.From your composer.json file:
API documentation
The detailed documentation of the API can be extracted from the code by using PhpDocumentor.
The file phpdoc.xml contains the required configuration for PhpDocumentor.
To generate the API documentation, just move into the root directory of this package and run PhpDocumentor from this location.
Note:
Since all the PHP code is documented using PhpDoc annotations, you should be able to exploit the auto completion feature from your favourite IDE. If you are using Eclipse, NetBeans or PhPStorm, you probably won’t need to consult the generated API documentation.
Synopsis
Specify inputs:
Create a set of specifications:
Test a set of inputs' values against the set of specifications:
Inspect the status.
Examples
example.php: this example shows how to use the package.
