CardScheme

Дата оновлення перекладу 2023-09-24

CardScheme

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

?????????????? ?? ??????????? ??? ??????
???? CardScheme
????????? CardSchemeValidator

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

Щоб використати валідатор CardScheme, застосуйте його до властивості або методу в обʼєкті, який міститиме номер кредитної карти.

1
2
3
4
5
6
7
8
9
10
11
12
13
// src/Entity/Transaction.php
namespace App\Entity;

use Symfony\Component\Validator\Constraints as Assert;

class Transaction
{
    #[Assert\CardScheme(
        schemes: [Assert\CardScheme::VISA],
        message: 'Your credit card number is invalid.',
    )]
    protected string $cardNumber;
}

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

Note

Як і в більшості інших обмежень, null та порожні рядки вважаються валідними значеннями. Це для того, щоб дозволити їм бути опціональними значеннями. Якщо значення є обовʼязковим, розповсюдженим рішенням буде комбінація цього обмеження з NotBlank.

Доступні опції

Дата оновлення перекладу 2023-09-24

groups

тип: array | string за замовчуванням: null

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

message

тип: string за замовчуванням: Непідтримуваний тип карти або невалідний номер карти.

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

Ви можете використати наступні параметри у цьому повідомленні:

???????? ????
{{ value }} ??????? (?? ???????) ????????
{{ label }} ??????????? ????? ???? ?????

Дата оновлення перекладу 2024-05-29

payload

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

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

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

schemes

тип: mixed [опція за замовчуванням ]

Ця опція обовʼязкова і представляє імʼя номерної схеми, використовуваної для валідації номеру кредитної карти, вона може бути рядком або масивом. Валідні значення:

  • AMEX
  • CHINA_UNIONPAY
  • DINERS
  • DISCOVER
  • INSTAPAYMENT
  • JCB
  • LASER
  • MAESTRO
  • MASTERCARD
  • MIR
  • UATP
  • VISA

Щоб дізнатися більше про використану схему, див. Вікіпедія: Ідентифікаційний номер емітента (IIN).