mirror of https://github.com/Respect/Validation.git synced 2026-03-14 22:35:45 +01:00

Henrique Moody d2198dfd01

Replace isValid() calls with assert()

There's more value on showing how `assert()` displays the validation
messages than simply showing if `isValid()` returns `true` or `false`.

However, that increases the chances of having outdated documentation, so
I created a doc linter that updates the Markdown files with the
correct message.

2026-01-13 23:37:06 -07:00

2 KiB

Raw Blame History

Call

Call(callable $callable, Validator $validator)

Validates the return of a [callable][] for a given input.

Consider the following variable:

$url = 'http://www.google.com/search?q=respect.github.com';

To validate every part of this URL we could use the native parse_url function to break its parts:

$parts = parse_url($url);

This function returns an array containing scheme, host, path and query. We can validate them this way:

v::arrayVal()
    ->key('scheme', v::startsWith('http'))
    ->key('host', v::domain())
    ->key('path', v::stringType())
    ->key('query', v::notBlank());

Using v::call() you can do this in a single chain:

v::call(
    'parse_url',
     v::arrayVal()
        ->key('scheme', v::startsWith('http'))
        ->key('host',   v::domain())
        ->key('path',   v::stringType())
        ->key('query',  v::notBlank())
)->assert($url);
// Validation passes successfully

Templates

`Call::TEMPLATE_STANDARD`

Mode	Template
`default`	{{input}} must be a suitable argument for {{callable}}
`inverted`	{{input}} must not be a suitable argument for {{callable}}

Template placeholders

Placeholder	Description
`callable`
`input`
`subject`	The validated input or the custom validator name (if specified).

Categorization

Callables
Nesting
Transformations

Changelog

Version	Description
0.3.9	Created

2 KiB Raw Blame History