davidepastore / slim-validation
A slim middleware for validation based on Respect/Validation
Installs: 198 595
Dependents: 5
Suggesters: 0
Security: 0
Stars: 170
Watchers: 7
Forks: 30
Open Issues: 17
Requires
- php: ^7.2
- psr/http-message: ^1.0
- respect/validation: ^1.1 >=1.1.23
- slim/http: ^1.1
- slim/psr7: ^0.3|^1.6
Requires (Dev)
- phpunit/phpunit: ^8.0
- scrutinizer/ocular: 1.5.*
- slim/slim: ~4.0
This package is auto-updated.
Last update: 2024-10-29 03:58:46 UTC
README
A validation library for the Slim Framework. It internally uses Respect/Validation.
Table of contents
Install
Via Composer
$ composer require davidepastore/slim-validation
Requires Slim 4.0.0 or newer.
Usage
In most cases you want to register DavidePastore\Slim\Validation
for a single route, however,
as it is middleware, you can also register it for all routes.
Register per route
use Respect\Validation\Validator as v; use Slim\Factory\AppFactory; require __DIR__ . '/../vendor/autoload.php'; $app = AppFactory::create(); //Create the validators $usernameValidator = v::alnum()->noWhitespace()->length(1, 10); $ageValidator = v::numeric()->positive()->between(1, 20); $validators = array( 'username' => $usernameValidator, 'age' => $ageValidator ); $app->get('/api/myEndPoint',function ($req, $res, $args) { //Here you expect 'username' and 'age' parameters if($req->getAttribute('has_errors')){ //There are errors, read them $errors = $req->getAttribute('errors'); /* $errors contains: array( 'username' => array( '"davidepastore" must have a length between 1 and 10', ), 'age' => array( '"89" must be lower than or equals 20', ), ); */ } else { //No errors } })->add(new \DavidePastore\Slim\Validation\Validation($validators)); $app->run();
Register for all routes
use Respect\Validation\Validator as v; use Slim\Factory\AppFactory; require __DIR__ . '/../vendor/autoload.php'; $app = AppFactory::create(); //Create the validators $usernameValidator = v::alnum()->noWhitespace()->length(1, 10); $ageValidator = v::numeric()->positive()->between(1, 20); $validators = array( 'username' => $usernameValidator, 'age' => $ageValidator ); // Register middleware for all routes // If you are implementing per-route checks you must not add this $app->add(new \DavidePastore\Slim\Validation\Validation($validators)); $app->get('/foo', function ($req, $res, $args) { //Here you expect 'username' and 'age' parameters if($req->getAttribute('has_errors')){ //There are errors, read them $errors = $req->getAttribute('errors'); /* $errors contains: array( 'username' => array( '"davidepastore" must have a length between 1 and 10', ), 'age' => array( '"89" must be lower than or equals 20', ), ); */ } else { //No errors } }); $app->post('/bar', function ($req, $res, $args) { //Here you expect 'username' and 'age' parameters if($req->getAttribute('has_errors')){ //There are errors, read them $errors = $req->getAttribute('errors'); } else { //No errors } }); $app->run();
Route parameters
use Respect\Validation\Validator as v; use Slim\Factory\AppFactory; require __DIR__ . '/../vendor/autoload.php'; $app = AppFactory::create(); //Create the validators $routeParamValidator = v::numeric()->positive(); $validators = array( 'param' => $routeParamValidator, ); $app->get('/foo/{param}', function ($req, $res, $args) { //Here you expect 'param' route parameter if($req->getAttribute('has_errors')){ //There are errors, read them $errors = $req->getAttribute('errors'); /* $errors contains: array( 'param' => array( '"wrong" must be numeric', ), ); */ } else { //No errors } })->add(new \DavidePastore\Slim\Validation\Validation($validators)); $app->run();
Note that requests parameters take priority over route parameters, so if you use the same name for a route and request parameter, the last will win and it will be considered for validation.
JSON requests
You can also validate a JSON request. Let's say your body request is:
{ "type": "emails", "objectid": "1", "email": { "id": 1, "enable_mapping": "1", "name": "rq3r", "created_at": "2016-08-23 13:36:29", "updated_at": "2016-08-23 14:36:47" } }
and you want to validate the email.name
key. You can do it in this way:
use Respect\Validation\Validator as v; use Slim\Factory\AppFactory; require __DIR__ . '/../vendor/autoload.php'; $app = AppFactory::create(); //Create the validators $typeValidator = v::alnum()->noWhitespace()->length(3, 5); $emailNameValidator = v::alnum()->noWhitespace()->length(1, 2); $validators = array( 'type' => $typeValidator, 'email' => array( 'name' => $emailNameValidator, ), );
If you'll have an error, the result would be:
//In your route $errors = $req->getAttribute('errors'); print_r($errors); /* Array ( [email.name] => Array ( [0] => "rq3r" must have a length between 1 and 2 ) ) */
XML requests
You can also validate a XML request. Let's say your body request is:
Let's say you have a POST request with a XML in its body:
<person> <type>emails</type> <objectid>1</objectid> <email> <id>1</id> <enable_mapping>1</enable_mapping> <name>rq3r</name> <created_at>2016-08-23 13:36:29</created_at> <updated_at>2016-08-23 14:36:47</updated_at> </email> </person>
and you want to validate the email.name
key. You can do it in this way:
use Respect\Validation\Validator as v; use Slim\Factory\AppFactory; require __DIR__ . '/../vendor/autoload.php'; $app = AppFactory::create(); //Create the validators $typeValidator = v::alnum()->noWhitespace()->length(3, 5); $emailNameValidator = v::alnum()->noWhitespace()->length(1, 2); $validators = array( 'type' => $typeValidator, 'email' => array( 'name' => $emailNameValidator, ), );
If you'll have an error, the result would be:
//In your route $errors = $req->getAttribute('errors'); print_r($errors); /* Array ( [email.name] => Array ( [0] => "rq3r" must have a length between 1 and 2 ) ) */
Translate errors
You can provide a callable function to translate the errors.
use Respect\Validation\Validator as v; use Slim\Factory\AppFactory; require __DIR__ . '/../vendor/autoload.php'; $app = AppFactory::create(); //Create the validators $usernameValidator = v::alnum()->noWhitespace()->length(1, 10); $ageValidator = v::numeric()->positive()->between(1, 20); $validators = array( 'username' => $usernameValidator, 'age' => $ageValidator ); $translator = function($message){ $messages = [ 'These rules must pass for {{name}}' => 'Queste regole devono passare per {{name}}', '{{name}} must be a string' => '{{name}} deve essere una stringa', '{{name}} must have a length between {{minValue}} and {{maxValue}}' => '{{name}} deve avere una dimensione di caratteri compresa tra {{minValue}} e {{maxValue}}', ]; return $messages[$message]; }; $middleware = new \DavidePastore\Slim\Validation\Validation($validators, $translator); // Register middleware for all routes or only for one... $app->run();
Testing
$ vendor\bin\phpunit
Contributing
Please see CONTRIBUTING for details.