respect-validation/tests/feature/GetMessagesTest.php
Henrique Moody b5ad7aa47a
Make Validator immutable
Mutable objects can be challenging to work with in larger codebases
because different parts of a system may modify the same instance, making
it difficult to trace where and when changes occurred. This becomes
especially problematic when debugging unexpected behaviour.

By making `Validator` immutable, we ensure that adding rules via
`with()` returns a new instance rather than mutating the original, and
we use the `with()` method inside `__call()`, making every call to a
rule into a clone of the current `Validator`.

This provides several benefits:

1. Predictability: A `Validator` instance will always behave the same
   way throughout its lifetime, regardless of what other parts of the
   codebase do.

2. Safe dependency injection: Users can now confidently inject a base
   `Validator` from a DI container, knowing that any modifications made
   elsewhere will not affect their instance.

3. Easier debugging: Since validators cannot be mutated after creation,
   there's no need to track down where an unexpected rule was added.

4. Reusability: Users can create an initial `Validator` with some base
   rules and reuse it by just adding new rules to the chain without
   affecting the base `Validator`.
2026-01-02 15:45:23 +01:00

39 lines
1.6 KiB
PHP

<?php
/*
* Copyright (c) Alexandre Gomes Gaigalas <alganet@gmail.com>
* SPDX-License-Identifier: MIT
*/
declare(strict_types=1);
test('Scenario #1', catchMessages(
fn() => v::init()
->key('mysql', v::init()
->key('host', v::stringType())
->key('user', v::stringType())->key('password', v::stringType())
->key('schema', v::stringType()))
->key('postgresql', v::init()
->key('host', v::stringType())
->key('user', v::stringType())
->key('password', v::stringType())
->key('schema', v::stringType()))
->assert(['mysql' => ['host' => 42, 'schema' => 42], 'postgresql' => ['user' => 42, 'password' => 42]]),
fn(array $messages) => expect($messages)->toBe([
'__root__' => '`["mysql": ["host": 42, "schema": 42], "postgresql": ["user": 42, "password": 42]]` must pass all the rules',
'mysql' => [
'__root__' => '`.mysql` must pass all the rules',
'host' => '`.mysql.host` must be a string',
'user' => '`.mysql.user` must be present',
'password' => '`.mysql.password` must be present',
'schema' => '`.mysql.schema` must be a string',
],
'postgresql' => [
'__root__' => '`.postgresql` must pass all the rules',
'host' => '`.postgresql.host` must be present',
'user' => '`.postgresql.user` must be a string',
'password' => '`.postgresql.password` must be a string',
'schema' => '`.postgresql.schema` must be present',
],
]),
));