UserPassword

Дата обновления перевода 2023-09-25

UserPassword

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

Note

Это не должно быть использовано для валидации формы входа, так как это делается автоматически системой безопасности.

Note

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

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

Базовое применение

Представьте, что у вас есть класс ChangePassword, который используется в форме, где пользователь может изменять свой пароль, введя старый и новый пароли. Это ограничение валидирует, что старый пароль совпадает с текущим паролем пользователя:

        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: 'Wrong value for your current password',
    )]
    protected string $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: 'Wrong value for your current password'
    

        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">Wrong value for your current password</option>
            </constraint>
        </property>
    </class>
</constraint-mapping>
    

        1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
        // 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): void
    {
        $metadata->addPropertyConstraint(
            'oldPassword',
            new SecurityAssert\UserPassword([
                'message' => 'Wrong value for your current password',
            ])
        );
    }
}
    

Опции

`groups`

type: array | string default: null

It defines the validation group or groups of this constraint. Read more about validation groups.

`message`

тип: message по умолчанию: Это значение должно быть текущим паролем пользователя.

Это сообщение, которое отображается, когда основоположная строка не совпадает с текущим паролем пользователя.

Это сообщение не имеет параметров.

Дата обновления перевода 2024-07-25

payload

тип: mixed по умолчанию: null

Эта опция может быть использована, чтобы добавить к ограничению произвольные данные, относящиеся к домену. Сконфигурированная нагрузка не используется компонентом Валидатор, но его обработка полностью зависит от вас.

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