Skip to main content
Drupal API
User account menu
  • Log in

Breadcrumb

  1. Drupal Core 11.1.x
  2. CardSchemeValidator.php

class CardSchemeValidator

Validates that a card number belongs to a specified scheme.

@author Tim Nagel <t.nagel@infinite.net.au> @author Bernhard Schussek <bschussek@gmail.com>

Hierarchy

  • class \Symfony\Component\Validator\ConstraintValidator implements \Symfony\Component\Validator\ConstraintValidatorInterface
    • class \Symfony\Component\Validator\Constraints\CardSchemeValidator extends \Symfony\Component\Validator\ConstraintValidator

Expanded class hierarchy of CardSchemeValidator

See also

https://en.wikipedia.org/wiki/Payment_card_number

https://www.regular-expressions.info/creditcard.html

File

vendor/symfony/validator/Constraints/CardSchemeValidator.php, line 27

Namespace

Symfony\Component\Validator\Constraints
View source
class CardSchemeValidator extends ConstraintValidator {
    protected array $schemes = [
        // American Express card numbers start with 34 or 37 and have 15 digits.
CardScheme::AMEX => [
            '/^3[47][0-9]{13}$/D',
        ],
        // China UnionPay cards start with 62 and have between 16 and 19 digits.
        // Please note that these cards do not follow Luhn Algorithm as a checksum.
CardScheme::CHINA_UNIONPAY => [
            '/^62[0-9]{14,17}$/D',
        ],
        // Diners Club card numbers begin with 300 through 305, 36 or 38. All have 14 digits.
        // There are Diners Club cards that begin with 5 and have 16 digits.
        // These are a joint venture between Diners Club and MasterCard, and should be processed like a MasterCard.
CardScheme::DINERS => [
            '/^3(?:0[0-5]|[68][0-9])[0-9]{11}$/D',
        ],
        // Discover card numbers begin with 6011, 622126 through 622925, 644 through 649 or 65.
        // All have 16 digits.
CardScheme::DISCOVER => [
            '/^6011[0-9]{12}$/D',
            '/^64[4-9][0-9]{13}$/D',
            '/^65[0-9]{14}$/D',
            '/^622(12[6-9]|1[3-9][0-9]|[2-8][0-9][0-9]|91[0-9]|92[0-5])[0-9]{10}$/D',
        ],
        // InstaPayment cards begin with 637 through 639 and have 16 digits.
CardScheme::INSTAPAYMENT => [
            '/^63[7-9][0-9]{13}$/D',
        ],
        // JCB cards beginning with 2131 or 1800 have 15 digits.
        // JCB cards beginning with 35 have 16 digits.
CardScheme::JCB => [
            '/^(?:2131|1800|35[0-9]{3})[0-9]{11}$/D',
        ],
        // Laser cards begin with either 6304, 6706, 6709 or 6771 and have between 16 and 19 digits.
CardScheme::LASER => [
            '/^(6304|670[69]|6771)[0-9]{12,15}$/D',
        ],
        // Maestro international cards begin with 675900..675999 and have between 12 and 19 digits.
        // Maestro UK cards begin with either 500000..509999 or 560000..699999 and have between 12 and 19 digits.
CardScheme::MAESTRO => [
            '/^(6759[0-9]{2})[0-9]{6,13}$/D',
            '/^(50[0-9]{4})[0-9]{6,13}$/D',
            '/^5[6-9][0-9]{10,17}$/D',
            '/^6[0-9]{11,18}$/D',
        ],
        // All MasterCard numbers start with the numbers 51 through 55. All have 16 digits.
        // October 2016 MasterCard numbers can also start with 222100 through 272099.
CardScheme::MASTERCARD => [
            '/^5[1-5][0-9]{14}$/D',
            '/^2(22[1-9][0-9]{12}|2[3-9][0-9]{13}|[3-6][0-9]{14}|7[0-1][0-9]{13}|720[0-9]{12})$/D',
        ],
        // Payment system MIR numbers start with 220, then 1 digit from 0 to 4, then between 12 and 15 digits
CardScheme::MIR => [
            '/^220[0-4][0-9]{12,15}$/D',
        ],
        // All UATP card numbers start with a 1 and have a length of 15 digits.
CardScheme::UATP => [
            '/^1[0-9]{14}$/D',
        ],
        // All Visa card numbers start with a 4 and have a length of 13, 16, or 19 digits.
CardScheme::VISA => [
            '/^4([0-9]{12}|[0-9]{15}|[0-9]{18})$/D',
        ],
    ];
    
    /**
     * Validates a creditcard belongs to a specified scheme.
     */
    public function validate(mixed $value, Constraint $constraint) : void {
        if (!$constraint instanceof CardScheme) {
            throw new UnexpectedTypeException($constraint, CardScheme::class);
        }
        if (null === $value || '' === $value) {
            return;
        }
        if (!is_numeric($value)) {
            $this->context
                ->buildViolation($constraint->message)
                ->setParameter('{{ value }}', $this->formatValue($value))
                ->setCode(CardScheme::NOT_NUMERIC_ERROR)
                ->addViolation();
            return;
        }
        $schemes = array_flip((array) $constraint->schemes);
        $schemeRegexes = array_intersect_key($this->schemes, $schemes);
        foreach ($schemeRegexes as $regexes) {
            foreach ($regexes as $regex) {
                if (preg_match($regex, $value)) {
                    return;
                }
            }
        }
        $this->context
            ->buildViolation($constraint->message)
            ->setParameter('{{ value }}', $this->formatValue($value))
            ->setCode(CardScheme::INVALID_FORMAT_ERROR)
            ->addViolation();
    }

}

Members

Title Sort descending Modifiers Object type Summary Overriden Title
CardSchemeValidator::$schemes protected property
CardSchemeValidator::validate public function Validates a creditcard belongs to a specified scheme. Overrides ConstraintValidatorInterface::validate
ConstraintValidator::$context protected property
ConstraintValidator::formatTypeOf protected function Returns a string representation of the type of the value.
ConstraintValidator::formatValue protected function Returns a string representation of the value.
ConstraintValidator::formatValues protected function Returns a string representation of a list of values.
ConstraintValidator::initialize public function Initializes the constraint validator. Overrides ConstraintValidatorInterface::initialize
ConstraintValidator::OBJECT_TO_STRING public constant Whether to cast objects with a &quot;__toString()&quot; method to strings.
ConstraintValidator::PRETTY_DATE public constant Whether to format {@link \DateTime} objects, either with the {@link \IntlDateFormatter}
(if it is available) or as RFC-3339 dates (&quot;Y-m-d H:i:s&quot;).
RSS feed
Powered by Drupal