UserPassword

Дата оновлення перекладу 2022-12-20

UserPassword

Це валідує, що значення введення дорівнює поточному паролю аутентифікованого користувача. Це корисно у формі, де користувач може змінювати свій пароль, але має ввести свій старий пароль для безпеки.

Note

Це не має бути використано для валідації форми входу в систему, так як це робиться автоматично системою безпеки.

Note

Для того, щоб використати це обмеження, ви маєте встановити компонент symfony/security-core за допомогою Composer.

?????????????? ??	??????????? ??? ??????
????	UserPassword
?????????	UserPasswordValidator

Базове застосування

Уявіть, що у вас є клас ChangePassword, який використовується у формі, де користувач може змінювати свій пароль, шляхом введення старого пароля та нового пароля. Це обмеження валідує, що старий пароль співпадає з поточним паролем користувача:

Attributes
YAML
XML
PHP

        1
2
3
4
5
6
7
8
9
10
11
12
        // src/Form/Model/ChangePassword.php
namespace App\Form\Model;

use Symfony\Component\Security\Core\Validator\Constraints as SecurityAssert;

class ChangePassword
{
    #[SecurityAssert\UserPassword(
        message: 'Невірне значення вашого поточного пароля',
    )]
    protected $oldPassword;
}
    

        1
2
3
4
5
6
        # config/validator/validation.yaml
App\Form\Model\ChangePassword:
    properties:
        oldPassword:
            - Symfony\Component\Security\Core\Validator\Constraints\UserPassword:
                message: 'Невірне значення вашого поточного пароля'
    

        1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
        <!-- config/validator/validation.xml -->
<?xml version="1.0" encoding="UTF-8" ?>
<constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping https://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">

    <class name="App\Form\Model\ChangePassword">
        <property name="oldPassword">
            <constraint
                name="Symfony\Component\Security\Core\Validator\Constraints\UserPassword"
            >
                <option name="message">Невірне значення вашого поточного пароля</option>
            </constraint>
        </property>
    </class>
</constraint-mapping>
    

        1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
        // src/Form/Model/ChangePassword.php
namespace App\Form\Model;

use Symfony\Component\Security\Core\Validator\Constraints as SecurityAssert;
use Symfony\Component\Validator\Mapping\ClassMetadata;

class ChangePassword
{
    public static function loadValidatorData(ClassMetadata $metadata)
    {
        $metadata->addPropertyConstraint(
            'oldPassword',
            new SecurityAssert\UserPassword([
                'message' => 'Невірне значення вашого поточного пароля',
            ])
        );
    }
}
    

Опції

Дата оновлення перекладу 2022-12-20

`groups`

тип: array | string

Визначаэ групу або групи валідації обмеження. Прочитайте більше про групи валідації.

`message`

тип: message за замовчуванням: Це значення має бути поточним паролем користувача.

Це повідомлення, яке відображається, коли вихідний рядок не співпадає з поточним паролем користувачає.

This message has no parameters.

Дата оновлення перекладу 2022-12-20

`payload`

тип: mixed за замовчуванням: null

Ця опція може бути використана, щоб додати довільні дані, специфічні для домену, до обмеження. Сконфігуроване корисне навантаження не використовується компонентом Validator, але його обробка повністю залежить від вас.

Наприклад, ви можете захотіти використати декілька рівнів помилок, щоб представити неуспішні обмеження по-різному у фронтенді, залежно від серйозності помилки.