Compare commits

..

No commits in common. "df150f0d860dbc2311e5e2fcb2fac36ee52db56b" and "9c837fd1944133edfed70a63ce8b32bf67f0d94b" have entirely different histories.

2 changed files with 4 additions and 13 deletions

View file

@ -1,11 +1,11 @@
# Request validation plugin for the [Reflect API Framework](https://codeberg.org/reflect/reflect)
# Request validation plugin for the [Reflect API Framework](https://github.com/victorwesterlund/reflect)
This request pre-processor adds request validation for an API written in the Reflect API Framework.
Write safer Reflect endpoints by enforcing request data structure validation before the request reaches your endpoint's logic. This plugin validates GET and POST data (even JSON) and returns an array with scoped `Error`s that can be further acted upon if desired.
## Example
*Example:*
```
POST Request: /my-endpoint?key1=lorem-ipsum&key2=dolor
GET Request: /my-endpoint?key1=lorem-ipsum&key2=dolor
POST Body: {"key3":15, "key4":["hello", "world"]}
```
```php
@ -16,7 +16,7 @@ use \ReflectRules\Type;
use \ReflectRules\Rules;
use \ReflectRules\Ruleset;
class POST_MyEndpoint implements Endpoint {
class GET_MyEndpoint implements Endpoint {
private Ruleset $rules;
public function __construct() {
@ -71,8 +71,6 @@ Ruleset->get_errors();
Use `Ruleset->is_valid(): bool` to quickly check if any errors are set.
You can also use `Ruleset->validate_or_exit(): true|Response` to automatically return a `Reflect\Response` with all errors to current STDOUT if validation fails.
# Installation
Install with composer

View file

@ -4,8 +4,6 @@
use \ReflectRules\Rules;
use \Reflect\Response;
require_once "Rules.php";
// Available superglobal scopes
@ -171,9 +169,4 @@
return $this->is_valid;
}
// Return Reflect\Response with errors and code 422 Unprocessable Content if validation failed
public function validate_or_exit(): true|Response {
return $this->is_valid() ? true : new Response($this->errors, 422);
}
}