respect-validation/tests/feature/GetMessagesWithReplacementsTest.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

64 lines
2.2 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,
],
],
[
'mysql' => [
'user' => 'Value should be a MySQL username',
'host' => '`{{subject}}` should be a MySQL host',
],
'postgresql' => ['schema' => 'You must provide a valid PostgreSQL schema'],
],
),
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`` should be a MySQL host',
'user' => 'Value should be a MySQL username',
'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' => 'You must provide a valid PostgreSQL schema',
],
]),
));