<?php
/**
* CakePHP(tm) : Rapid Development Framework (https://cakephp.org)
* Copyright (c) Cake Software Foundation, Inc. (https://cakefoundation.org)
*
* Licensed under The MIT License
* For full copyright and license information, please see the LICENSE.txt
* Redistributions of files must retain the above copyright notice.
*
* @copyright Copyright (c) Cake Software Foundation, Inc. (https://cakefoundation.org)
* @link https://cakephp.org CakePHP(tm) Project
* @since 1.2.0
* @license https://opensource.org/licenses/mit-license.php MIT License
*/
namespace Cake\Validation;
use Cake\I18n\Time;
use Cake\Utility\Text;
use DateTimeInterface;
use InvalidArgumentException;
use LogicException;
use NumberFormatter;
use Psr\Http\Message\UploadedFileInterface;
use RuntimeException;
/**
* Validation Class. Used for validation of model data
*
* Offers different validation methods.
*/
class Validation
{
/**
* Default locale
*
* @var string
*/
const DEFAULT_LOCALE = 'en_US';
/**
* Same as operator.
*
* @var string
*/
const COMPARE_SAME = '===';
/**
* Not same as comparison operator.
*
* @var string
*/
const COMPARE_NOT_SAME = '!==';
/**
* Equal to comparison operator.
*
* @var string
*/
const COMPARE_EQUAL = '==';
/**
* Not equal to comparison operator.
*
* @var string
*/
const COMPARE_NOT_EQUAL = '!=';
/**
* Greater than comparison operator.
*
* @var string
*/
const COMPARE_GREATER = '>';
/**
* Greater than or equal to comparison operator.
*
* @var string
*/
const COMPARE_GREATER_OR_EQUAL = '>=';
/**
* Less than comparison operator.
*
* @var string
*/
const COMPARE_LESS = '<';
/**
* Less than or equal to comparison operator.
*
* @var string
*/
const COMPARE_LESS_OR_EQUAL = '<=';
/**
* Datetime ISO8601 format
*
* @var string
*/
const DATETIME_ISO8601 = 'iso8601';
/**
* Some complex patterns needed in multiple places
*
* @var array
*/
protected static $_pattern = [
'hostname' => '(?:[_\p{L}0-9][-_\p{L}0-9]*\.)*(?:[\p{L}0-9][-\p{L}0-9]{0,62})\.(?:(?:[a-z]{2}\.)?[a-z]{2,})',
'latitude' => '[-+]?([1-8]?\d(\.\d+)?|90(\.0+)?)',
'longitude' => '[-+]?(180(\.0+)?|((1[0-7]\d)|([1-9]?\d))(\.\d+)?)',
];
/**
* Holds an array of errors messages set in this class.
* These are used for debugging purposes
*
* @var array
*/
public static $errors = [];
/**
* Backwards compatibility wrapper for Validation::notBlank().
*
* @param string $check Value to check.
* @return bool Success.
* @deprecated 3.0.2 Use Validation::notBlank() instead.
* @see \Cake\Validation\Validation::notBlank()
*/
public static function notEmpty($check)
{
deprecationWarning(
'Validation::notEmpty() is deprecated. ' .
'Use Validation::notBlank() instead.'
);
return static::notBlank($check);
}
/**
* Checks that a string contains something other than whitespace
*
* Returns true if string contains something other than whitespace
*
* @param string $check Value to check
* @return bool Success
*/
public static function notBlank($check)
{
if (empty($check) && !is_bool($check) && !is_numeric($check)) {
return false;
}
return static::_check($check, '/[^\s]+/m');
}
/**
* Checks that a string contains only integer or letters
*
* Returns true if string contains only integer or letters
*
* @param string $check Value to check
* @return bool Success
*/
public static function alphaNumeric($check)
{
if (empty($check) && $check !== '0') {
return false;
}
return self::_check($check, '/^[\p{Ll}\p{Lm}\p{Lo}\p{Lt}\p{Lu}\p{Nd}]+$/Du');
}
/**
* Checks that a string length is within specified range.
* Spaces are included in the character count.
* Returns true if string matches value min, max, or between min and max,
*
* @param string $check Value to check for length
* @param int $min Minimum value in range (inclusive)
* @param int $max Maximum value in range (inclusive)
* @return bool Success
*/
public static function lengthBetween($check, $min, $max)
{
if (!is_string($check)) {
return false;
}
$length = mb_strlen($check);
return ($length >= $min && $length <= $max);
}
/**
* Returns true if field is left blank -OR- only whitespace characters are present in its value
* Whitespace characters include Space, Tab, Carriage Return, Newline
*
* @param string $check Value to check
* @return bool Success
* @deprecated 3.0.2 Validation::blank() is deprecated.
*/
public static function blank($check)
{
deprecationWarning(
'Validation::blank() is deprecated.'
);
return !static::_check($check, '/[^\\s]/');
}
/**
* Backwards compatibility wrapper for Validation::creditCard().
*
* @param string $check credit card number to validate
* @param string|string[] $type 'all' may be passed as a string, defaults to fast which checks format of most major credit cards
* if an array is used only the values of the array are checked.
* Example: ['amex', 'bankcard', 'maestro']
* @param bool $deep set to true this will check the Luhn algorithm of the credit card.
* @param string|null $regex A custom regex can also be passed, this will be used instead of the defined regex values
* @return bool Success
* @deprecated 3.7.0 Use Validation::creditCard() instead.
* @see \Cake\Validation\Validation::creditCard()
*/
public static function cc($check, $type = 'fast', $deep = false, $regex = null)
{
deprecationWarning(
'Validation::cc() is deprecated. ' .
'Use Validation::creditCard() instead.'
);
return static::creditCard($check, $type, $deep, $regex);
}
/**
* Validation of credit card numbers.
* Returns true if $check is in the proper credit card format.
*
* @param string $check credit card number to validate
* @param string|array $type 'all' may be passed as a string, defaults to fast which checks format of most major credit cards
* if an array is used only the values of the array are checked.
* Example: ['amex', 'bankcard', 'maestro']
* @param bool $deep set to true this will check the Luhn algorithm of the credit card.
* @param string|null $regex A custom regex can also be passed, this will be used instead of the defined regex values
* @return bool Success
* @see \Cake\Validation\Validation::luhn()
*/
public static function creditCard($check, $type = 'fast', $deep = false, $regex = null)
{
if (!is_scalar($check)) {
return false;
}
$check = str_replace(['-', ' '], '', $check);
if (mb_strlen($check) < 13) {
return false;
}
if ($regex !== null && static::_check($check, $regex)) {
return !$deep || static::luhn($check);
}
$cards = [
'all' => [
'amex' => '/^3[47]\\d{13}$/',
'bankcard' => '/^56(10\\d\\d|022[1-5])\\d{10}$/',
'diners' => '/^(?:3(0[0-5]|[68]\\d)\\d{11})|(?:5[1-5]\\d{14})$/',
'disc' => '/^(?:6011|650\\d)\\d{12}$/',
'electron' => '/^(?:417500|4917\\d{2}|4913\\d{2})\\d{10}$/',
'enroute' => '/^2(?:014|149)\\d{11}$/',
'jcb' => '/^(3\\d{4}|2131|1800)\\d{11}$/',
'maestro' => '/^(?:5020|6\\d{3})\\d{12}$/',
'mc' => '/^(5[1-5]\\d{14})|(2(?:22[1-9]|2[3-9][0-9]|[3-6][0-9]{2}|7[0-1][0-9]|720)\\d{12})$/',
'solo' => '/^(6334[5-9][0-9]|6767[0-9]{2})\\d{10}(\\d{2,3})?$/',
'switch' => '/^(?:49(03(0[2-9]|3[5-9])|11(0[1-2]|7[4-9]|8[1-2])|36[0-9]{2})\\d{10}(\\d{2,3})?)|(?:564182\\d{10}(\\d{2,3})?)|(6(3(33[0-4][0-9])|759[0-9]{2})\\d{10}(\\d{2,3})?)$/',
'visa' => '/^4\\d{12}(\\d{3})?$/',
'voyager' => '/^8699[0-9]{11}$/',
],
'fast' => '/^(?:4[0-9]{12}(?:[0-9]{3})?|5[1-5][0-9]{14}|6011[0-9]{12}|3(?:0[0-5]|[68][0-9])[0-9]{11}|3[47][0-9]{13})$/',
];
if (is_array($type)) {
foreach ($type as $value) {
$regex = $cards['all'][strtolower($value)];
if (static::_check($check, $regex)) {
return static::luhn($check);
}
}
} elseif ($type === 'all') {
foreach ($cards['all'] as $value) {
$regex = $value;
if (static::_check($check, $regex)) {
return static::luhn($check);
}
}
} else {
$regex = $cards['fast'];
if (static::_check($check, $regex)) {
return static::luhn($check);
}
}
return false;
}
/**
* Used to check the count of a given value of type array or Countable.
*
* @param array|\Countable $check The value to check the count on.
* @param string $operator Can be either a word or operand
* is greater >, is less <, greater or equal >=
* less or equal <=, is less <, equal to ==, not equal !=
* @param int $expectedCount The expected count value.
* @return bool Success
*/
public static function numElements($check, $operator, $expectedCount)
{
if (!is_array($check) && !$check instanceof \Countable) {
return false;
}
return self::comparison(count($check), $operator, $expectedCount);
}
/**
* Used to compare 2 numeric values.
*
* @param string $check1 The left value to compare.
* @param string $operator Can be either a word or operand
* is greater >, is less <, greater or equal >=
* less or equal <=, is less <, equal to ==, not equal !=
* @param int $check2 The right value to compare.
* @return bool Success
*/
public static function comparison($check1, $operator, $check2)
{
if ((float)$check1 != $check1) {
return false;
}
$message = 'Operator `%s` is deprecated, use constant `Validation::%s` instead.';
$operator = str_replace([' ', "\t", "\n", "\r", "\0", "\x0B"], '', strtolower($operator));
switch ($operator) {
case 'isgreater':
/*
* @deprecated 3.6.0 Use Validation::COMPARE_GREATER instead.
*/
deprecationWarning(sprintf($message, $operator, 'COMPARE_GREATER'));
// no break
case static::COMPARE_GREATER:
if ($check1 > $check2) {
return true;
}
break;
case 'isless':
/*
* @deprecated 3.6.0 Use Validation::COMPARE_LESS instead.
*/
deprecationWarning(sprintf($message, $operator, 'COMPARE_LESS'));
// no break
case static::COMPARE_LESS:
if ($check1 < $check2) {
return true;
}
break;
case 'greaterorequal':
/*
* @deprecated 3.6.0 Use Validation::COMPARE_GREATER_OR_EQUAL instead.
*/
deprecationWarning(sprintf($message, $operator, 'COMPARE_GREATER_OR_EQUAL'));
// no break
case static::COMPARE_GREATER_OR_EQUAL:
if ($check1 >= $check2) {
return true;
}
break;
case 'lessorequal':
/*
* @deprecated 3.6.0 Use Validation::COMPARE_LESS_OR_EQUAL instead.
*/
deprecationWarning(sprintf($message, $operator, 'COMPARE_LESS_OR_EQUAL'));
// no break
case static::COMPARE_LESS_OR_EQUAL:
if ($check1 <= $check2) {
return true;
}
break;
case 'equalto':
/*
* @deprecated 3.6.0 Use Validation::COMPARE_EQUAL instead.
*/
deprecationWarning(sprintf($message, $operator, 'COMPARE_EQUAL'));
// no break
case static::COMPARE_EQUAL:
if ($check1 == $check2) {
return true;
}
break;
case 'notequal':
/*
* @deprecated 3.6.0 Use Validation::COMPARE_NOT_EQUAL instead.
*/
deprecationWarning(sprintf($message, $operator, 'COMPARE_NOT_EQUAL'));
// no break
case static::COMPARE_NOT_EQUAL:
if ($check1 != $check2) {
return true;
}
break;
case static::COMPARE_SAME:
if ($check1 === $check2) {
return true;
}
break;
case static::COMPARE_NOT_SAME:
if ($check1 !== $check2) {
return true;
}
break;
default:
static::$errors[] = 'You must define the $operator parameter for Validation::comparison()';
}
return false;
}
/**
* Compare one field to another.
*
* If both fields have exactly the same value this method will return true.
*
* @param mixed $check The value to find in $field.
* @param string $field The field to check $check against. This field must be present in $context.
* @param array $context The validation context.
* @return bool
*/
public static function compareWith($check, $field, $context)
{
return self::compareFields($check, $field, static::COMPARE_SAME, $context);
}
/**
* Compare one field to another.
*
* Return true if the comparison matches the expected result.
*
* @param mixed $check The value to find in $field.
* @param string $field The field to check $check against. This field must be present in $context.
* @param string $operator Comparison operator.
* @param array $context The validation context.
* @return bool
* @since 3.6.0
*/
public static function compareFields($check, $field, $operator, $context)
{
if (!isset($context['data']) || !array_key_exists($field, $context['data'])) {
return false;
}
return static::comparison($check, $operator, $context['data'][$field]);
}
/**
* Checks if a string contains one or more non-alphanumeric characters.
*
* Returns true if string contains at least the specified number of non-alphanumeric characters
*
* @param string $check Value to check
* @param int $count Number of non-alphanumerics to check for
* @return bool Success
*/
public static function containsNonAlphaNumeric($check, $count = 1)
{
if (!is_scalar($check)) {
return false;
}
$matches = preg_match_all('/[^a-zA-Z0-9]/', $check);
return $matches >= $count;
}
/**
* Used when a custom regular expression is needed.
*
* @param string $check The value to check.
* @param string|null $regex If $check is passed as a string, $regex must also be set to valid regular expression
* @return bool Success
*/
public static function custom($check, $regex = null)
{
if ($regex === null) {
static::$errors[] = 'You must define a regular expression for Validation::custom()';
return false;
}
return static::_check($check, $regex);
}
/**
* Date validation, determines if the string passed is a valid date.
* keys that expect full month, day and year will validate leap years.
*
* Years are valid from 0001 to 2999.
*
* ### Formats:
*
* - `dmy` 27-12-2006 or 27-12-06 separators can be a space, period, dash, forward slash
* - `mdy` 12-27-2006 or 12-27-06 separators can be a space, period, dash, forward slash
* - `ymd` 2006-12-27 or 06-12-27 separators can be a space, period, dash, forward slash
* - `dMy` 27 December 2006 or 27 Dec 2006
* - `Mdy` December 27, 2006 or Dec 27, 2006 comma is optional
* - `My` December 2006 or Dec 2006
* - `my` 12/2006 or 12/06 separators can be a space, period, dash, forward slash
* - `ym` 2006/12 or 06/12 separators can be a space, period, dash, forward slash
* - `y` 2006 just the year without any separators
*
* @param string|\DateTimeInterface $check a valid date string/object
* @param string|array $format Use a string or an array of the keys above.
* Arrays should be passed as ['dmy', 'mdy', etc]
* @param string|null $regex If a custom regular expression is used this is the only validation that will occur.
* @return bool Success
*/
public static function date($check, $format = 'ymd', $regex = null)
{
if ($check instanceof DateTimeInterface) {
return true;
}
if (is_object($check)) {
return false;
}
if (is_array($check)) {
$check = static::_getDateString($check);
$format = 'ymd';
}
if ($regex !== null) {
return static::_check($check, $regex);
}
$month = '(0[123456789]|10|11|12)';
$separator = '([- /.])';
// Don't allow 0000, but 0001-2999 are ok.
$fourDigitYear = '(?:(?!0000)[012]\d{3})';
$twoDigitYear = '(?:\d{2})';
$year = '(?:' . $fourDigitYear . '|' . $twoDigitYear . ')';
// 2 or 4 digit leap year sub-pattern
$leapYear = '(?:(?:(?:(?!0000)[012]\\d)?(?:0[48]|[2468][048]|[13579][26])|(?:(?:16|[2468][048]|[3579][26])00)))';
// 4 digit leap year sub-pattern
$fourDigitLeapYear = '(?:(?:(?:(?!0000)[012]\\d)(?:0[48]|[2468][048]|[13579][26])|(?:(?:16|[2468][048]|[3579][26])00)))';
$regex['dmy'] = '%^(?:(?:31(\\/|-|\\.|\\x20)(?:0?[13578]|1[02]))\\1|(?:(?:29|30)' .
$separator . '(?:0?[1,3-9]|1[0-2])\\2))' . $year . '$|^(?:29' .
$separator . '0?2\\3' . $leapYear . ')$|^(?:0?[1-9]|1\\d|2[0-8])' .
$separator . '(?:(?:0?[1-9])|(?:1[0-2]))\\4' . $year . '$%';
$regex['mdy'] = '%^(?:(?:(?:0?[13578]|1[02])(\\/|-|\\.|\\x20)31)\\1|(?:(?:0?[13-9]|1[0-2])' .
$separator . '(?:29|30)\\2))' . $year . '$|^(?:0?2' . $separator . '29\\3' . $leapYear . ')$|^(?:(?:0?[1-9])|(?:1[0-2]))' .
$separator . '(?:0?[1-9]|1\\d|2[0-8])\\4' . $year . '$%';
$regex['ymd'] = '%^(?:(?:' . $leapYear .
$separator . '(?:0?2\\1(?:29)))|(?:' . $year .
$separator . '(?:(?:(?:0?[13578]|1[02])\\2(?:31))|(?:(?:0?[1,3-9]|1[0-2])\\2(29|30))|(?:(?:0?[1-9])|(?:1[0-2]))\\2(?:0?[1-9]|1\\d|2[0-8]))))$%';
$regex['dMy'] = '/^((31(?!\\ (Feb(ruary)?|Apr(il)?|June?|(Sep(?=\\b|t)t?|Nov)(ember)?)))|((30|29)(?!\\ Feb(ruary)?))|(29(?=\\ Feb(ruary)?\\ ' . $fourDigitLeapYear . '))|(0?[1-9])|1\\d|2[0-8])\\ (Jan(uary)?|Feb(ruary)?|Ma(r(ch)?|y)|Apr(il)?|Ju((ly?)|(ne?))|Aug(ust)?|Oct(ober)?|(Sep(?=\\b|t)t?|Nov|Dec)(ember)?)\\ ' . $fourDigitYear . '$/';
$regex['Mdy'] = '/^(?:(((Jan(uary)?|Ma(r(ch)?|y)|Jul(y)?|Aug(ust)?|Oct(ober)?|Dec(ember)?)\\ 31)|((Jan(uary)?|Ma(r(ch)?|y)|Apr(il)?|Ju((ly?)|(ne?))|Aug(ust)?|Oct(ober)?|(Sep)(tember)?|(Nov|Dec)(ember)?)\\ (0?[1-9]|([12]\\d)|30))|(Feb(ruary)?\\ (0?[1-9]|1\\d|2[0-8]|(29(?=,?\\ ' . $fourDigitLeapYear . ')))))\\,?\\ ' . $fourDigitYear . ')$/';
$regex['My'] = '%^(Jan(uary)?|Feb(ruary)?|Ma(r(ch)?|y)|Apr(il)?|Ju((ly?)|(ne?))|Aug(ust)?|Oct(ober)?|(Sep(?=\\b|t)t?|Nov|Dec)(ember)?)' .
$separator . $fourDigitYear . '$%';
$regex['my'] = '%^(' . $month . $separator . $year . ')$%';
$regex['ym'] = '%^(' . $year . $separator . $month . ')$%';
$regex['y'] = '%^(' . $fourDigitYear . ')$%';
$format = is_array($format) ? array_values($format) : [$format];
foreach ($format as $key) {
if (static::_check($check, $regex[$key]) === true) {
return true;
}
}
return false;
}
/**
* Validates a datetime value
*
* All values matching the "date" core validation rule, and the "time" one will be valid
*
* @param string|\DateTimeInterface $check Value to check
* @param string|array $dateFormat Format of the date part. See Validation::date() for more information.
* Or `Validation::DATETIME_ISO8601` to valid an ISO8601 datetime value
* @param string|null $regex Regex for the date part. If a custom regular expression is used this is the only validation that will occur.
* @return bool True if the value is valid, false otherwise
* @see \Cake\Validation\Validation::date()
* @see \Cake\Validation\Validation::time()
*/
public static function datetime($check, $dateFormat = 'ymd', $regex = null)
{
if ($check instanceof DateTimeInterface) {
return true;
}
if (is_object($check)) {
return false;
}
if ($dateFormat === static::DATETIME_ISO8601 && !static::iso8601($check)) {
return false;
}
$valid = false;
if (is_array($check)) {
$check = static::_getDateString($check);
$dateFormat = 'ymd';
}
$parts = preg_split("/[\sT]+/", $check);
if (!empty($parts) && count($parts) > 1) {
$date = rtrim(array_shift($parts), ',');
$time = implode(' ', $parts);
if ($dateFormat === static::DATETIME_ISO8601) {
$dateFormat = 'ymd';
$time = preg_split("/[TZ\-\+\.]/", $time);
$time = array_shift($time);
}
$valid = static::date($date, $dateFormat, $regex) && static::time($time);
}
return $valid;
}
/**
* Validates an iso8601 datetime format
* ISO8601 recognize datetime like 2019 as a valid date. To validate and check date integrity, use @see \Cake\Validation\Validation::datetime()
*
* @param string|\DateTimeInterface $check Value to check
*
* @return bool True if the value is valid, false otherwise
*
* @see Regex credits: https://www.myintervals.com/blog/2009/05/20/iso-8601-date-validation-that-doesnt-suck/
*/
public static function iso8601($check)
{
if ($check instanceof DateTimeInterface) {
return true;
}
if (is_object($check)) {
return false;
}
$regex = '/^([\+-]?\d{4}(?!\d{2}\b))((-?)((0[1-9]|1[0-2])(\3([12]\d|0[1-9]|3[01]))?|W([0-4]\d|5[0-2])(-?[1-7])?|(00[1-9]|0[1-9]\d|[12]\d{2}|3([0-5]\d|6[1-6])))([T\s]((([01]\d|2[0-3])((:?)[0-5]\d)?|24\:?00)([\.,]\d+(?!:))?)?(\17[0-5]\d([\.,]\d+)?)?([zZ]|([\+-])([01]\d|2[0-3]):?([0-5]\d)?)?)?)?$/';
return static::_check($check, $regex);
}
/**
* Time validation, determines if the string passed is a valid time.
* Validates time as 24hr (HH:MM) or am/pm ([H]H:MM[a|p]m)
* Does not allow/validate seconds.
*
* @param string|\DateTimeInterface $check a valid time string/object
* @return bool Success
*/
public static function time($check)
{
if ($check instanceof DateTimeInterface) {
return true;
}
if (is_array($check)) {
$check = static::_getDateString($check);
}
return static::_check($check, '%^((0?[1-9]|1[012])(:[0-5]\d){0,2} ?([AP]M|[ap]m))$|^([01]\d|2[0-3])(:[0-5]\d){0,2}$%');
}
/**
* Date and/or time string validation.
* Uses `I18n::Time` to parse the date. This means parsing is locale dependent.
*
* @param string|\DateTime $check a date string or object (will always pass)
* @param string $type Parser type, one out of 'date', 'time', and 'datetime'
* @param string|int|null $format any format accepted by IntlDateFormatter
* @return bool Success
* @throws \InvalidArgumentException when unsupported $type given
* @see \Cake\I18n\Time::parseDate()
* @see \Cake\I18n\Time::parseTime()
* @see \Cake\I18n\Time::parseDateTime()
*/
public static function localizedTime($check, $type = 'datetime', $format = null)
{
if ($check instanceof DateTimeInterface) {
return true;
}
if (is_object($check)) {
return false;
}
static $methods = [
'date' => 'parseDate',
'time' => 'parseTime',
'datetime' => 'parseDateTime',
];
if (empty($methods[$type])) {
throw new InvalidArgumentException('Unsupported parser type given.');
}
$method = $methods[$type];
return (Time::$method($check, $format) !== null);
}
/**
* Validates if passed value is boolean-like.
*
* The list of what is considered to be boolean values, may be set via $booleanValues.
*
* @param bool|int|string $check Value to check.
* @param array $booleanValues List of valid boolean values, defaults to `[true, false, 0, 1, '0', '1']`.
* @return bool Success.
*/
public static function boolean($check, array $booleanValues = [])
{
if (!$booleanValues) {
$booleanValues = [true, false, 0, 1, '0', '1'];
}
return in_array($check, $booleanValues, true);
}
/**
* Validates if given value is truthy.
*
* The list of what is considered to be truthy values, may be set via $truthyValues.
*
* @param bool|int|string $check Value to check.
* @param array $truthyValues List of valid truthy values, defaults to `[true, 1, '1']`.
* @return bool Success.
*/
public static function truthy($check, array $truthyValues = [])
{
if (!$truthyValues) {
$truthyValues = [true, 1, '1'];
}
return in_array($check, $truthyValues, true);
}
/**
* Validates if given value is falsey.
*
* The list of what is considered to be falsey values, may be set via $falseyValues.
*
* @param bool|int|string $check Value to check.
* @param array $falseyValues List of valid falsey values, defaults to `[false, 0, '0']`.
* @return bool Success.
*/
public static function falsey($check, array $falseyValues = [])
{
if (!$falseyValues) {
$falseyValues = [false, 0, '0'];
}
return in_array($check, $falseyValues, true);
}
/**
* Checks that a value is a valid decimal. Both the sign and exponent are optional.
*
* Valid Places:
*
* - null => Any number of decimal places, including none. The '.' is not required.
* - true => Any number of decimal places greater than 0, or a float|double. The '.' is required.
* - 1..N => Exactly that many number of decimal places. The '.' is required.
*
* @param float $check The value the test for decimal.
* @param int|bool|null $places Decimal places.
* @param string|null $regex If a custom regular expression is used, this is the only validation that will occur.
* @return bool Success
*/
public static function decimal($check, $places = null, $regex = null)
{
if ($regex === null) {
$lnum = '[0-9]+';
$dnum = "[0-9]*[\.]{$lnum}";
$sign = '[+-]?';
$exp = "(?:[eE]{$sign}{$lnum})?";
if ($places === null) {
$regex = "/^{$sign}(?:{$lnum}|{$dnum}){$exp}$/";
} elseif ($places === true) {
if (is_float($check) && floor($check) === $check) {
$check = sprintf('%.1f', $check);
}
$regex = "/^{$sign}{$dnum}{$exp}$/";
} elseif (is_numeric($places)) {
$places = '[0-9]{' . $places . '}';
$dnum = "(?:[0-9]*[\.]{$places}|{$lnum}[\.]{$places})";
$regex = "/^{$sign}{$dnum}{$exp}$/";
}
}
// account for localized floats.
$locale = ini_get('intl.default_locale') ?: static::DEFAULT_LOCALE;
$formatter = new NumberFormatter($locale, NumberFormatter::DECIMAL);
$decimalPoint = $formatter->getSymbol(NumberFormatter::DECIMAL_SEPARATOR_SYMBOL);
$groupingSep = $formatter->getSymbol(NumberFormatter::GROUPING_SEPARATOR_SYMBOL);
// There are two types of non-breaking spaces - we inject a space to account for human input
if ($groupingSep == "\xc2\xa0" || $groupingSep == "\xe2\x80\xaf") {
$check = str_replace([' ', $groupingSep, $decimalPoint], ['', '', '.'], $check);
} else {
$check = str_replace([$groupingSep, $decimalPoint], ['', '.'], $check);
}
$check = str_replace([$groupingSep, $decimalPoint], ['', '.'], $check);
return static::_check($check, $regex);
}
/**
* Validates for an email address.
*
* Only uses getmxrr() checking for deep validation, or
* any PHP version on a non-windows distribution
*
* @param string $check Value to check
* @param bool $deep Perform a deeper validation (if true), by also checking availability of host
* @param string|null $regex Regex to use (if none it will use built in regex)
* @return bool Success
*/
public static function email($check, $deep = false, $regex = null)
{
if (!is_string($check)) {
return false;
}
if ($regex === null) {
$regex = '/^[\p{L}0-9!#$%&\'*+\/=?^_`{|}~-]+(?:\.[\p{L}0-9!#$%&\'*+\/=?^_`{|}~-]+)*@' . self::$_pattern['hostname'] . '$/ui';
}
$return = static::_check($check, $regex);
if ($deep === false || $deep === null) {
return $return;
}
if ($return === true && preg_match('/@(' . static::$_pattern['hostname'] . ')$/i', $check, $regs)) {
if (function_exists('getmxrr') && getmxrr($regs[1], $mxhosts)) {
return true;
}
if (function_exists('checkdnsrr') && checkdnsrr($regs[1], 'MX')) {
return true;
}
return is_array(gethostbynamel($regs[1] . '.'));
}
return false;
}
/**
* Checks that value is exactly $comparedTo.
*
* @param mixed $check Value to check
* @param mixed $comparedTo Value to compare
* @return bool Success
*/
public static function equalTo($check, $comparedTo)
{
return ($check === $comparedTo);
}
/**
* Checks that value has a valid file extension.
*
* @param string|array|\Psr\Http\Message\UploadedFileInterface $check Value to check
* @param array $extensions file extensions to allow. By default extensions are 'gif', 'jpeg', 'png', 'jpg'
* @return bool Success
*/
public static function extension($check, $extensions = ['gif', 'jpeg', 'png', 'jpg'])
{
if ($check instanceof UploadedFileInterface) {
return static::extension($check->getClientFilename(), $extensions);
}
if (is_array($check)) {
$check = isset($check['name']) ? $check['name'] : array_shift($check);
return static::extension($check, $extensions);
}
$extension = strtolower(pathinfo($check, PATHINFO_EXTENSION));
foreach ($extensions as $value) {
if ($extension === strtolower($value)) {
return true;
}
}
return false;
}
/**
* Validation of an IP address.
*
* @param string $check The string to test.
* @param string $type The IP Protocol version to validate against
* @return bool Success
*/
public static function ip($check, $type = 'both')
{
$type = strtolower($type);
$flags = 0;
if ($type === 'ipv4') {
$flags = FILTER_FLAG_IPV4;
}
if ($type === 'ipv6') {
$flags = FILTER_FLAG_IPV6;
}
return (bool)filter_var($check, FILTER_VALIDATE_IP, ['flags' => $flags]);
}
/**
* Checks whether the length of a string (in characters) is greater or equal to a minimal length.
*
* @param string $check The string to test
* @param int $min The minimal string length
* @return bool Success
*/
public static function minLength($check, $min)
{
if (!is_scalar($check)) {
return false;
}
return mb_strlen($check) >= $min;
}
/**
* Checks whether the length of a string (in characters) is smaller or equal to a maximal length.
*
* @param string $check The string to test
* @param int $max The maximal string length
* @return bool Success
*/
public static function maxLength($check, $max)
{
if (!is_scalar($check)) {
return false;
}
return mb_strlen($check) <= $max;
}
/**
* Checks whether the length of a string (in bytes) is greater or equal to a minimal length.
*
* @param string $check The string to test
* @param int $min The minimal string length (in bytes)
* @return bool Success
*/
public static function minLengthBytes($check, $min)
{
if (!is_scalar($check)) {
return false;
}
return strlen($check) >= $min;
}
/**
* Checks whether the length of a string (in bytes) is smaller or equal to a maximal length.
*
* @param string $check The string to test
* @param int $max The maximal string length
* @return bool Success
*/
public static function maxLengthBytes($check, $max)
{
if (!is_scalar($check)) {
return false;
}
return strlen($check) <= $max;
}
/**
* Checks that a value is a monetary amount.
*
* @param string $check Value to check
* @param string $symbolPosition Where symbol is located (left/right)
* @return bool Success
*/
public static function money($check, $symbolPosition = 'left')
{
$money = '(?!0,?\d)(?:\d{1,3}(?:([, .])\d{3})?(?:\1\d{3})*|(?:\d+))((?!\1)[,.]\d{1,2})?';
if ($symbolPosition === 'right') {
$regex = '/^' . $money . '(?<!\x{00a2})\p{Sc}?$/u';
} else {
$regex = '/^(?!\x{00a2})\p{Sc}?' . $money . '$/u';
}
return static::_check($check, $regex);
}
/**
* Validates a multiple select. Comparison is case sensitive by default.
*
* Valid Options
*
* - in => provide a list of choices that selections must be made from
* - max => maximum number of non-zero choices that can be made
* - min => minimum number of non-zero choices that can be made
*
* @param array $check Value to check
* @param array $options Options for the check.
* @param bool $caseInsensitive Set to true for case insensitive comparison.
* @return bool Success
*/
public static function multiple($check, array $options = [], $caseInsensitive = false)
{
$defaults = ['in' => null, 'max' => null, 'min' => null];
$options += $defaults;
$check = array_filter((array)$check, function ($value) {
return ($value || is_numeric($value));
});
if (empty($check)) {
return false;
}
if ($options['max'] && count($check) > $options['max']) {
return false;
}
if ($options['min'] && count($check) < $options['min']) {
return false;
}
if ($options['in'] && is_array($options['in'])) {
if ($caseInsensitive) {
$options['in'] = array_map('mb_strtolower', $options['in']);
}
foreach ($check as $val) {
$strict = !is_numeric($val);
if ($caseInsensitive) {
$val = mb_strtolower($val);
}
if (!in_array((string)$val, $options['in'], $strict)) {
return false;
}
}
}
return true;
}
/**
* Checks if a value is numeric.
*
* @param string $check Value to check
* @return bool Success
*/
public static function numeric($check)
{
return is_numeric($check);
}
/**
* Checks if a value is a natural number.
*
* @param string $check Value to check
* @param bool $allowZero Set true to allow zero, defaults to false
* @return bool Success
* @see https://en.wikipedia.org/wiki/Natural_number
*/
public static function naturalNumber($check, $allowZero = false)
{
$regex = $allowZero ? '/^(?:0|[1-9][0-9]*)$/' : '/^[1-9][0-9]*$/';
return static::_check($check, $regex);
}
/**
* Validates that a number is in specified range.
*
* If $lower and $upper are set, the range is inclusive.
* If they are not set, will return true if $check is a
* legal finite on this platform.
*
* @param string $check Value to check
* @param int|float|null $lower Lower limit
* @param int|float|null $upper Upper limit
* @return bool Success
*/
public static function range($check, $lower = null, $upper = null)
{
if (!is_numeric($check)) {
return false;
}
if ((float)$check != $check) {
return false;
}
if (isset($lower, $upper)) {
return ($check >= $lower && $check <= $upper);
}
return is_finite($check);
}
/**
* Checks that a value is a valid URL according to https://www.w3.org/Addressing/URL/url-spec.txt
*
* The regex checks for the following component parts:
*
* - a valid, optional, scheme
* - a valid ip address OR
* a valid domain name as defined by section 2.3.1 of https://www.ietf.org/rfc/rfc1035.txt
* with an optional port number
* - an optional valid path
* - an optional query string (get parameters)
* - an optional fragment (anchor tag) as defined in RFC 3986
*
* @param string $check Value to check
* @param bool $strict Require URL to be prefixed by a valid scheme (one of http(s)/ftp(s)/file/news/gopher)
* @return bool Success
* @link https://tools.ietf.org/html/rfc3986
*/
public static function url($check, $strict = false)
{
static::_populateIp();
$emoji = '\x{1F190}-\x{1F9EF}';
$alpha = '0-9\p{L}\p{N}' . $emoji;
$hex = '(%[0-9a-f]{2})';
$subDelimiters = preg_quote('/!"$&\'()*+,-.@_:;=~[]', '/');
$path = '([' . $subDelimiters . $alpha . ']|' . $hex . ')';
$fragmentAndQuery = '([\?' . $subDelimiters . $alpha . ']|' . $hex . ')';
$regex = '/^(?:(?:https?|ftps?|sftp|file|news|gopher):\/\/)' . (!empty($strict) ? '' : '?') .
'(?:' . static::$_pattern['IPv4'] . '|\[' . static::$_pattern['IPv6'] . '\]|' . static::$_pattern['hostname'] . ')(?::[1-9][0-9]{0,4})?' .
'(?:\/' . $path . '*)?' .
'(?:\?' . $fragmentAndQuery . '*)?' .
'(?:#' . $fragmentAndQuery . '*)?$/iu';
return static::_check($check, $regex);
}
/**
* Checks if a value is in a given list. Comparison is case sensitive by default.
*
* @param string $check Value to check.
* @param string[] $list List to check against.
* @param bool $caseInsensitive Set to true for case insensitive comparison.
* @return bool Success.
*/
public static function inList($check, array $list, $caseInsensitive = false)
{
if ($caseInsensitive) {
$list = array_map('mb_strtolower', $list);
$check = mb_strtolower($check);
} else {
$list = array_map('strval', $list);
}
return in_array((string)$check, $list, true);
}
/**
* Runs an user-defined validation.
*
* @param string|array $check value that will be validated in user-defined methods.
* @param object $object class that holds validation method
* @param string $method class method name for validation to run
* @param array|null $args arguments to send to method
* @return mixed user-defined class class method returns
* @deprecated 3.0.2 You can just set a callable for `rule` key when adding validators.
*/
public static function userDefined($check, $object, $method, $args = null)
{
deprecationWarning(
'Validation::userDefined() is deprecated. ' .
'You can just set a callable for `rule` key when adding validators.'
);
return $object->$method($check, $args);
}
/**
* Checks that a value is a valid UUID - https://tools.ietf.org/html/rfc4122
*
* @param string $check Value to check
* @return bool Success
*/
public static function uuid($check)
{
$regex = '/^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[0-5][a-fA-F0-9]{3}-[089aAbB][a-fA-F0-9]{3}-[a-fA-F0-9]{12}$/';
return self::_check($check, $regex);
}
/**
* Runs a regular expression match.
*
* @param string $check Value to check against the $regex expression
* @param string $regex Regular expression
* @return bool Success of match
*/
protected static function _check($check, $regex)
{
return is_string($regex) && is_scalar($check) && preg_match($regex, $check);
}
/**
* Luhn algorithm
*
* @param string|array $check Value to check.
* @return bool Success
* @see https://en.wikipedia.org/wiki/Luhn_algorithm
*/
public static function luhn($check)
{
if (!is_scalar($check) || (int)$check === 0) {
return false;
}
$sum = 0;
$length = strlen($check);
for ($position = 1 - ($length % 2); $position < $length; $position += 2) {
$sum += $check[$position];
}
for ($position = ($length % 2); $position < $length; $position += 2) {
$number = (int)$check[$position] * 2;
$sum += ($number < 10) ? $number : $number - 9;
}
return ($sum % 10 === 0);
}
/**
* Checks the mime type of a file.
*
* Will check the mimetype of files/UploadedFileInterface instances
* by checking the using finfo on the file, not relying on the content-type
* sent by the client.
*
* @param string|array|\Psr\Http\Message\UploadedFileInterface $check Value to check.
* @param array|string $mimeTypes Array of mime types or regex pattern to check.
* @return bool Success
* @throws \RuntimeException when mime type can not be determined.
* @throws \LogicException when ext/fileinfo is missing
*/
public static function mimeType($check, $mimeTypes = [])
{
$file = static::getFilename($check);
if ($file === false) {
return false;
}
if (!function_exists('finfo_open')) {
throw new LogicException('ext/fileinfo is required for validating file mime types');
}
if (!is_file($file)) {
throw new RuntimeException('Cannot validate mimetype for a missing file');
}
$finfo = finfo_open(FILEINFO_MIME);
$finfo = finfo_file($finfo, $file);
if (!$finfo) {
throw new RuntimeException('Can not determine the mimetype.');
}
list($mime) = explode(';', $finfo);
if (is_string($mimeTypes)) {
return self::_check($mime, $mimeTypes);
}
foreach ($mimeTypes as $key => $val) {
$mimeTypes[$key] = strtolower($val);
}
return in_array(strtolower($mime), $mimeTypes, true);
}
/**
* Helper for reading the file out of the various file implementations
* we accept.
*
* @param string|array|\Psr\Http\Message\UploadedFileInterface $check The data to read a filename out of.
* @return string|false Either the filename or false on failure.
*/
protected static function getFilename($check)
{
if ($check instanceof UploadedFileInterface) {
try {
// Uploaded files throw exceptions on upload errors.
return $check->getStream()->getMetadata('uri');
} catch (RuntimeException $e) {
return false;
}
}
if (is_array($check) && isset($check['tmp_name'])) {
return $check['tmp_name'];
}
if (is_string($check)) {
return $check;
}
return false;
}
/**
* Checks the filesize
*
* Will check the filesize of files/UploadedFileInterface instances
* by checking the filesize() on disk and not relying on the length
* reported by the client.
*
* @param string|array|\Psr\Http\Message\UploadedFileInterface $check Value to check.
* @param string|null $operator See `Validation::comparison()`.
* @param int|string|null $size Size in bytes or human readable string like '5MB'.
* @return bool Success
*/
public static function fileSize($check, $operator = null, $size = null)
{
$file = static::getFilename($check);
if ($file === false) {
return false;
}
if (is_string($size)) {
$size = Text::parseFileSize($size);
}
$filesize = filesize($file);
return static::comparison($filesize, $operator, $size);
}
/**
* Checking for upload errors
*
* @param string|array|\Psr\Http\Message\UploadedFileInterface $check Value to check.
* @param bool $allowNoFile Set to true to allow UPLOAD_ERR_NO_FILE as a pass.
* @return bool
* @see https://secure.php.net/manual/en/features.file-upload.errors.php
*/
public static function uploadError($check, $allowNoFile = false)
{
if ($check instanceof UploadedFileInterface) {
$code = $check->getError();
} elseif (is_array($check) && isset($check['error'])) {
$code = $check['error'];
} else {
$code = $check;
}
if ($allowNoFile) {
return in_array((int)$code, [UPLOAD_ERR_OK, UPLOAD_ERR_NO_FILE], true);
}
return (int)$code === UPLOAD_ERR_OK;
}
/**
* Validate an uploaded file.
*
* Helps join `uploadError`, `fileSize` and `mimeType` into
* one higher level validation method.
*
* ### Options
*
* - `types` - An array of valid mime types. If empty all types
* will be accepted. The `type` will not be looked at, instead
* the file type will be checked with ext/finfo.
* - `minSize` - The minimum file size in bytes. Defaults to not checking.
* - `maxSize` - The maximum file size in bytes. Defaults to not checking.
* - `optional` - Whether or not this file is optional. Defaults to false.
* If true a missing file will pass the validator regardless of other constraints.
*
* @param array|\Psr\Http\Message\UploadedFileInterface $file The uploaded file data from PHP.
* @param array $options An array of options for the validation.
* @return bool
*/
public static function uploadedFile($file, array $options = [])
{
$options += [
'minSize' => null,
'maxSize' => null,
'types' => null,
'optional' => false,
];
if (!is_array($file) && !($file instanceof UploadedFileInterface)) {
return false;
}
$error = $isUploaded = false;
if ($file instanceof UploadedFileInterface) {
$error = $file->getError();
$isUploaded = true;
}
if (is_array($file)) {
$keys = ['error', 'name', 'size', 'tmp_name', 'type'];
ksort($file);
if (array_keys($file) != $keys) {
return false;
}
$error = (int)$file['error'];
$isUploaded = is_uploaded_file($file['tmp_name']);
}
if (!static::uploadError($file, $options['optional'])) {
return false;
}
if ($options['optional'] && $error === UPLOAD_ERR_NO_FILE) {
return true;
}
if (isset($options['minSize']) && !static::fileSize($file, static::COMPARE_GREATER_OR_EQUAL, $options['minSize'])) {
return false;
}
if (isset($options['maxSize']) && !static::fileSize($file, static::COMPARE_LESS_OR_EQUAL, $options['maxSize'])) {
return false;
}
if (isset($options['types']) && !static::mimeType($file, $options['types'])) {
return false;
}
return $isUploaded;
}
/**
* Validates the size of an uploaded image.
*
* @param array|\Psr\Http\Message\UploadedFileInterface $file The uploaded file data from PHP.
* @param array $options Options to validate width and height.
* @return bool
* @throws \InvalidArgumentException
*/
public static function imageSize($file, $options)
{
if (!isset($options['height']) && !isset($options['width'])) {
throw new InvalidArgumentException('Invalid image size validation parameters! Missing `width` and / or `height`.');
}
$filename = static::getFilename($file);
list($width, $height) = getimagesize($filename);
$validHeight = $validWidth = null;
if (isset($options['height'])) {
$validHeight = self::comparison($height, $options['height'][0], $options['height'][1]);
}
if (isset($options['width'])) {
$validWidth = self::comparison($width, $options['width'][0], $options['width'][1]);
}
if ($validHeight !== null && $validWidth !== null) {
return ($validHeight && $validWidth);
}
if ($validHeight !== null) {
return $validHeight;
}
if ($validWidth !== null) {
return $validWidth;
}
throw new InvalidArgumentException('The 2nd argument is missing the `width` and / or `height` options.');
}
/**
* Validates the image width.
*
* @param array $file The uploaded file data from PHP.
* @param string $operator Comparison operator.
* @param int $width Min or max width.
* @return bool
*/
public static function imageWidth($file, $operator, $width)
{
return self::imageSize($file, [
'width' => [
$operator,
$width,
],
]);
}
/**
* Validates the image width.
*
* @param array $file The uploaded file data from PHP.
* @param string $operator Comparison operator.
* @param int $height Min or max width.
* @return bool
*/
public static function imageHeight($file, $operator, $height)
{
return self::imageSize($file, [
'height' => [
$operator,
$height,
],
]);
}
/**
* Validates a geographic coordinate.
*
* Supported formats:
*
* - `<latitude>, <longitude>` Example: `-25.274398, 133.775136`
*
* ### Options
*
* - `type` - A string of the coordinate format, right now only `latLong`.
* - `format` - By default `both`, can be `long` and `lat` as well to validate
* only a part of the coordinate.
*
* @param string $value Geographic location as string
* @param array $options Options for the validation logic.
* @return bool
*/
public static function geoCoordinate($value, array $options = [])
{
$options += [
'format' => 'both',
'type' => 'latLong',
];
if ($options['type'] !== 'latLong') {
throw new RuntimeException(sprintf(
'Unsupported coordinate type "%s". Use "latLong" instead.',
$options['type']
));
}
$pattern = '/^' . self::$_pattern['latitude'] . ',\s*' . self::$_pattern['longitude'] . '$/';
if ($options['format'] === 'long') {
$pattern = '/^' . self::$_pattern['longitude'] . '$/';
}
if ($options['format'] === 'lat') {
$pattern = '/^' . self::$_pattern['latitude'] . '$/';
}
return (bool)preg_match($pattern, $value);
}
/**
* Convenience method for latitude validation.
*
* @param string $value Latitude as string
* @param array $options Options for the validation logic.
* @return bool
* @link https://en.wikipedia.org/wiki/Latitude
* @see \Cake\Validation\Validation::geoCoordinate()
*/
public static function latitude($value, array $options = [])
{
$options['format'] = 'lat';
return self::geoCoordinate($value, $options);
}
/**
* Convenience method for longitude validation.
*
* @param string $value Latitude as string
* @param array $options Options for the validation logic.
* @return bool
* @link https://en.wikipedia.org/wiki/Longitude
* @see \Cake\Validation\Validation::geoCoordinate()
*/
public static function longitude($value, array $options = [])
{
$options['format'] = 'long';
return self::geoCoordinate($value, $options);
}
/**
* Check that the input value is within the ascii byte range.
*
* This method will reject all non-string values.
*
* @param string $value The value to check
* @return bool
*/
public static function ascii($value)
{
if (!is_string($value)) {
return false;
}
return strlen($value) <= mb_strlen($value, 'utf-8');
}
/**
* Check that the input value is a utf8 string.
*
* This method will reject all non-string values.
*
* # Options
*
* - `extended` - Disallow bytes higher within the basic multilingual plane.
* MySQL's older utf8 encoding type does not allow characters above
* the basic multilingual plane. Defaults to false.
*
* @param string $value The value to check
* @param array $options An array of options. See above for the supported options.
* @return bool
*/
public static function utf8($value, array $options = [])
{
if (!is_string($value)) {
return false;
}
$options += ['extended' => false];
if ($options['extended']) {
return true;
}
return preg_match('/[\x{10000}-\x{10FFFF}]/u', $value) === 0;
}
/**
* Check that the input value is an integer
*
* This method will accept strings that contain only integer data
* as well.
*
* @param string $value The value to check
* @return bool
*/
public static function isInteger($value)
{
if (!is_numeric($value) || is_float($value)) {
return false;
}
if (is_int($value)) {
return true;
}
return (bool)preg_match('/^-?[0-9]+$/', $value);
}
/**
* Check that the input value is an array.
*
* @param array $value The value to check
* @return bool
*/
public static function isArray($value)
{
return is_array($value);
}
/**
* Check that the input value is a scalar.
*
* This method will accept integers, floats, strings and booleans, but
* not accept arrays, objects, resources and nulls.
*
* @param mixed $value The value to check
* @return bool
*/
public static function isScalar($value)
{
return is_scalar($value);
}
/**
* Check that the input value is a 6 digits hex color.
*
* @param string|array $check The value to check
* @return bool Success
*/
public static function hexColor($check)
{
return static::_check($check, '/^#[0-9a-f]{6}$/iD');
}
/**
* Check that the input value has a valid International Bank Account Number IBAN syntax
* Requirements are uppercase, no whitespaces, max length 34, country code and checksum exist at right spots,
* body matches against checksum via Mod97-10 algorithm
*
* @param string $check The value to check
*
* @return bool Success
*/
public static function iban($check)
{
if (!preg_match('/^[A-Z]{2}[0-9]{2}[A-Z0-9]{1,30}$/', $check)) {
return false;
}
$country = substr($check, 0, 2);
$checkInt = intval(substr($check, 2, 2));
$account = substr($check, 4);
$search = range('A', 'Z');
$replace = [];
foreach (range(10, 35) as $tmp) {
$replace[] = strval($tmp);
}
$numStr = str_replace($search, $replace, $account . $country . '00');
$checksum = intval(substr($numStr, 0, 1));
$numStrLength = strlen($numStr);
for ($pos = 1; $pos < $numStrLength; $pos++) {
$checksum *= 10;
$checksum += intval(substr($numStr, $pos, 1));
$checksum %= 97;
}
return ((98 - $checksum) === $checkInt);
}
/**
* Converts an array representing a date or datetime into a ISO string.
* The arrays are typically sent for validation from a form generated by
* the CakePHP FormHelper.
*
* @param array $value The array representing a date or datetime.
* @return string
*/
protected static function _getDateString($value)
{
$formatted = '';
if (
isset($value['year'], $value['month'], $value['day']) &&
(is_numeric($value['year']) && is_numeric($value['month']) && is_numeric($value['day']))
) {
$formatted .= sprintf('%d-%02d-%02d ', $value['year'], $value['month'], $value['day']);
}
if (isset($value['hour'])) {
if (isset($value['meridian']) && (int)$value['hour'] === 12) {
$value['hour'] = 0;
}
if (isset($value['meridian'])) {
$value['hour'] = strtolower($value['meridian']) === 'am' ? $value['hour'] : $value['hour'] + 12;
}
$value += ['minute' => 0, 'second' => 0];
if (is_numeric($value['hour']) && is_numeric($value['minute']) && is_numeric($value['second'])) {
$formatted .= sprintf('%02d:%02d:%02d', $value['hour'], $value['minute'], $value['second']);
}
}
return trim($formatted);
}
/**
* Lazily populate the IP address patterns used for validations
*
* @return void
*/
protected static function _populateIp()
{
if (!isset(static::$_pattern['IPv6'])) {
$pattern = '((([0-9A-Fa-f]{1,4}:){7}(([0-9A-Fa-f]{1,4})|:))|(([0-9A-Fa-f]{1,4}:){6}';
$pattern .= '(:|((25[0-5]|2[0-4]\d|[01]?\d{1,2})(\.(25[0-5]|2[0-4]\d|[01]?\d{1,2})){3})';
$pattern .= '|(:[0-9A-Fa-f]{1,4})))|(([0-9A-Fa-f]{1,4}:){5}((:((25[0-5]|2[0-4]\d|[01]?\d{1,2})';
$pattern .= '(\.(25[0-5]|2[0-4]\d|[01]?\d{1,2})){3})?)|((:[0-9A-Fa-f]{1,4}){1,2})))|(([0-9A-Fa-f]{1,4}:)';
$pattern .= '{4}(:[0-9A-Fa-f]{1,4}){0,1}((:((25[0-5]|2[0-4]\d|[01]?\d{1,2})(\.(25[0-5]|2[0-4]\d|[01]?\d{1,2}))';
$pattern .= '{3})?)|((:[0-9A-Fa-f]{1,4}){1,2})))|(([0-9A-Fa-f]{1,4}:){3}(:[0-9A-Fa-f]{1,4}){0,2}';
$pattern .= '((:((25[0-5]|2[0-4]\d|[01]?\d{1,2})(\.(25[0-5]|2[0-4]\d|[01]?\d{1,2})){3})?)|';
$pattern .= '((:[0-9A-Fa-f]{1,4}){1,2})))|(([0-9A-Fa-f]{1,4}:){2}(:[0-9A-Fa-f]{1,4}){0,3}';
$pattern .= '((:((25[0-5]|2[0-4]\d|[01]?\d{1,2})(\.(25[0-5]|2[0-4]\d|[01]?\d{1,2}))';
$pattern .= '{3})?)|((:[0-9A-Fa-f]{1,4}){1,2})))|(([0-9A-Fa-f]{1,4}:)(:[0-9A-Fa-f]{1,4})';
$pattern .= '{0,4}((:((25[0-5]|2[0-4]\d|[01]?\d{1,2})(\.(25[0-5]|2[0-4]\d|[01]?\d{1,2})){3})?)';
$pattern .= '|((:[0-9A-Fa-f]{1,4}){1,2})))|(:(:[0-9A-Fa-f]{1,4}){0,5}((:((25[0-5]|2[0-4]';
$pattern .= '\d|[01]?\d{1,2})(\.(25[0-5]|2[0-4]\d|[01]?\d{1,2})){3})?)|((:[0-9A-Fa-f]{1,4})';
$pattern .= '{1,2})))|(((25[0-5]|2[0-4]\d|[01]?\d{1,2})(\.(25[0-5]|2[0-4]\d|[01]?\d{1,2})){3})))(%.+)?';
static::$_pattern['IPv6'] = $pattern;
}
if (!isset(static::$_pattern['IPv4'])) {
$pattern = '(?:(?:25[0-5]|2[0-4][0-9]|(?:(?:1[0-9])?|[1-9]?)[0-9])\.){3}(?:25[0-5]|2[0-4][0-9]|(?:(?:1[0-9])?|[1-9]?)[0-9])';
static::$_pattern['IPv4'] = $pattern;
}
}
/**
* Reset internal variables for another validation run.
*
* @return void
*/
protected static function _reset()
{
static::$errors = [];
}
}