423 lines
10 KiB
PHP
423 lines
10 KiB
PHP
<?php defined('SYSPATH') OR die('No direct access allowed.');
|
|
/**
|
|
* Validation helper class.
|
|
*
|
|
* @package Core
|
|
* @author Kohana Team
|
|
* @copyright (c) 2007-2009 Kohana Team
|
|
* @license http://kohanaphp.com/license.html
|
|
*/
|
|
class valid_Core {
|
|
|
|
/**
|
|
* Checks if a value is empty and optionally checks that the type of the
|
|
* value matches the required type.
|
|
*
|
|
* @param mixed value
|
|
* @param string required type
|
|
* @return boolean
|
|
*/
|
|
public static function required( & $value, $type = TRUE)
|
|
{
|
|
if (empty($value))
|
|
{
|
|
// The value is empty
|
|
return FALSE;
|
|
}
|
|
|
|
if ($type === TRUE)
|
|
{
|
|
// There is a value present
|
|
return TRUE;
|
|
}
|
|
|
|
return $type === gettype($value);
|
|
}
|
|
|
|
/**
|
|
* Checks a field against a regular expression.
|
|
*
|
|
* @param string value
|
|
* @param string regular expression to match
|
|
* @return boolean
|
|
*/
|
|
public static function regex($value, $expression)
|
|
{
|
|
return (bool) preg_match($expression, (string) $value);
|
|
}
|
|
|
|
/**
|
|
* Checks that a field is long enough.
|
|
*
|
|
* @param string value
|
|
* @param integer minimum length required
|
|
* @return boolean
|
|
*/
|
|
public static function min_length($value, $length)
|
|
{
|
|
return strlen($value) >= $length;
|
|
}
|
|
|
|
/**
|
|
* Checks that a field is short enough.
|
|
*
|
|
* @param string value
|
|
* @param integer maximum length required
|
|
* @return boolean
|
|
*/
|
|
public static function max_length($value, $length)
|
|
{
|
|
return strlen($value) <= $length;
|
|
}
|
|
|
|
/**
|
|
* Check a email address for correct format.
|
|
*
|
|
* @see http://www.iamcal.com/publish/articles/php/parsing_email/
|
|
* @see http://www.w3.org/Protocols/rfc822/
|
|
*
|
|
* @param string email address
|
|
* @param boolean strict RFC compatibility
|
|
* @return boolean
|
|
*/
|
|
public static function email($email, $strict = FALSE)
|
|
{
|
|
if ($strict === TRUE)
|
|
{
|
|
$qtext = '[^\\x0d\\x22\\x5c\\x80-\\xff]';
|
|
$dtext = '[^\\x0d\\x5b-\\x5d\\x80-\\xff]';
|
|
$atom = '[^\\x00-\\x20\\x22\\x28\\x29\\x2c\\x2e\\x3a-\\x3c\\x3e\\x40\\x5b-\\x5d\\x7f-\\xff]+';
|
|
$pair = '\\x5c[\\x00-\\x7f]';
|
|
|
|
$domain_literal = "\\x5b($dtext|$pair)*\\x5d";
|
|
$quoted_string = "\\x22($qtext|$pair)*\\x22";
|
|
$sub_domain = "($atom|$domain_literal)";
|
|
$word = "($atom|$quoted_string)";
|
|
$domain = "$sub_domain(\\x2e$sub_domain)*";
|
|
$local_part = "$word(\\x2e$word)*";
|
|
|
|
$expression = "/^$local_part\\x40$domain$/D";
|
|
}
|
|
else
|
|
{
|
|
$expression = '/^[-_a-z0-9\'+*$^&%=~!?{}]++(?:\.[-_a-z0-9\'+*$^&%=~!?{}]+)*+@(?:(?![-.])[-a-z0-9.]+(?<![-.])\.[a-z]{2,6}|\d{1,3}(?:\.\d{1,3}){3})(?::\d++)?$/iD';
|
|
}
|
|
|
|
return (bool) preg_match($expression, (string) $email);
|
|
}
|
|
|
|
/**
|
|
* Validate the domain of an email address by checking if the domain has a
|
|
* valid MX record.
|
|
*
|
|
* Note: checkdnsrr() was not added to Windows until PHP 5.3.0
|
|
*
|
|
* @param string email address
|
|
* @return boolean
|
|
*/
|
|
public static function email_domain($email)
|
|
{
|
|
// Check if the email domain has a valid MX record
|
|
return (bool) checkdnsrr(preg_replace('/^[^@]+@/', '', $email), 'MX');
|
|
}
|
|
|
|
/**
|
|
* Validate URL
|
|
*
|
|
* @param string URL
|
|
* @return boolean
|
|
*/
|
|
public static function url($url)
|
|
{
|
|
return (bool) filter_var($url, FILTER_VALIDATE_URL, FILTER_FLAG_HOST_REQUIRED);
|
|
}
|
|
|
|
/**
|
|
* Validate IP
|
|
*
|
|
* @param string IP address
|
|
* @param boolean allow private IP networks
|
|
* @return boolean
|
|
*/
|
|
public static function ip($ip, $allow_private = TRUE)
|
|
{
|
|
// Do not allow reserved addresses
|
|
$flags = FILTER_FLAG_NO_RES_RANGE;
|
|
|
|
if ($allow_private === FALSE)
|
|
{
|
|
// Do not allow private or reserved addresses
|
|
$flags = $flags | FILTER_FLAG_NO_PRIV_RANGE;
|
|
}
|
|
|
|
return (bool) filter_var($ip, FILTER_VALIDATE_IP, $flags);
|
|
}
|
|
|
|
/**
|
|
* Validates a credit card number using the Luhn (mod10) formula.
|
|
* @see http://en.wikipedia.org/wiki/Luhn_algorithm
|
|
*
|
|
* @param integer credit card number
|
|
* @param string|array card type, or an array of card types
|
|
* @return boolean
|
|
*/
|
|
public static function credit_card($number, $type = NULL)
|
|
{
|
|
// Remove all non-digit characters from the number
|
|
if (($number = preg_replace('/\D+/', '', $number)) === '')
|
|
return FALSE;
|
|
|
|
if ($type == NULL)
|
|
{
|
|
// Use the default type
|
|
$type = 'default';
|
|
}
|
|
elseif (is_array($type))
|
|
{
|
|
foreach ($type as $t)
|
|
{
|
|
// Test each type for validity
|
|
if (valid::credit_card($number, $t))
|
|
return TRUE;
|
|
}
|
|
|
|
return FALSE;
|
|
}
|
|
|
|
$cards = Kohana::config('credit_cards');
|
|
|
|
// Check card type
|
|
$type = strtolower($type);
|
|
|
|
if ( ! isset($cards[$type]))
|
|
return FALSE;
|
|
|
|
// Check card number length
|
|
$length = strlen($number);
|
|
|
|
// Validate the card length by the card type
|
|
if ( ! in_array($length, preg_split('/\D+/', $cards[$type]['length'])))
|
|
return FALSE;
|
|
|
|
// Check card number prefix
|
|
if ( ! preg_match('/^'.$cards[$type]['prefix'].'/', $number))
|
|
return FALSE;
|
|
|
|
// No Luhn check required
|
|
if ($cards[$type]['luhn'] == FALSE)
|
|
return TRUE;
|
|
|
|
// Checksum of the card number
|
|
$checksum = 0;
|
|
|
|
for ($i = $length - 1; $i >= 0; $i -= 2)
|
|
{
|
|
// Add up every 2nd digit, starting from the right
|
|
$checksum += substr($number, $i, 1);
|
|
}
|
|
|
|
for ($i = $length - 2; $i >= 0; $i -= 2)
|
|
{
|
|
// Add up every 2nd digit doubled, starting from the right
|
|
$double = substr($number, $i, 1) * 2;
|
|
|
|
// Subtract 9 from the double where value is greater than 10
|
|
$checksum += ($double >= 10) ? $double - 9 : $double;
|
|
}
|
|
|
|
// If the checksum is a multiple of 10, the number is valid
|
|
return ($checksum % 10 === 0);
|
|
}
|
|
|
|
/**
|
|
* Checks if a phone number is valid.
|
|
*
|
|
* @param string phone number to check
|
|
* @return boolean
|
|
*/
|
|
public static function phone($number, $lengths = NULL)
|
|
{
|
|
if ( ! is_array($lengths))
|
|
{
|
|
$lengths = array(7,10,11);
|
|
}
|
|
|
|
// Remove all non-digit characters from the number
|
|
$number = preg_replace('/\D+/', '', $number);
|
|
|
|
// Check if the number is within range
|
|
return in_array(strlen($number), $lengths);
|
|
}
|
|
|
|
/**
|
|
* Tests if a string is a valid date string.
|
|
*
|
|
* @param string date to check
|
|
* @return boolean
|
|
*/
|
|
public static function date($str)
|
|
{
|
|
return (strtotime($str) !== FALSE);
|
|
}
|
|
|
|
/**
|
|
* Checks whether a string consists of alphabetical characters only.
|
|
*
|
|
* @param string input string
|
|
* @param boolean trigger UTF-8 compatibility
|
|
* @return boolean
|
|
*/
|
|
public static function alpha($str, $utf8 = FALSE)
|
|
{
|
|
return ($utf8 === TRUE)
|
|
? (bool) preg_match('/^\pL++$/uD', (string) $str)
|
|
: ctype_alpha((string) $str);
|
|
}
|
|
|
|
/**
|
|
* Checks whether a string consists of alphabetical characters and numbers only.
|
|
*
|
|
* @param string input string
|
|
* @param boolean trigger UTF-8 compatibility
|
|
* @return boolean
|
|
*/
|
|
public static function alpha_numeric($str, $utf8 = FALSE)
|
|
{
|
|
return ($utf8 === TRUE)
|
|
? (bool) preg_match('/^[\pL\pN]++$/uD', (string) $str)
|
|
: ctype_alnum((string) $str);
|
|
}
|
|
|
|
/**
|
|
* Checks whether a string consists of alphabetical characters, numbers, underscores and dashes only.
|
|
*
|
|
* @param string input string
|
|
* @param boolean trigger UTF-8 compatibility
|
|
* @return boolean
|
|
*/
|
|
public static function alpha_dash($str, $utf8 = FALSE)
|
|
{
|
|
return ($utf8 === TRUE)
|
|
? (bool) preg_match('/^[-\pL\pN_]++$/uD', (string) $str)
|
|
: (bool) preg_match('/^[-a-z0-9_]++$/iD', (string) $str);
|
|
}
|
|
|
|
/**
|
|
* Checks whether a string consists of digits only (no dots or dashes).
|
|
*
|
|
* @param string input string
|
|
* @param boolean trigger UTF-8 compatibility
|
|
* @return boolean
|
|
*/
|
|
public static function digit($str, $utf8 = FALSE)
|
|
{
|
|
return ($utf8 === TRUE)
|
|
? (bool) preg_match('/^\pN++$/uD', (string) $str)
|
|
: ctype_digit((string) $str);
|
|
}
|
|
|
|
/**
|
|
* Checks whether a string is a valid number (negative and decimal numbers allowed).
|
|
*
|
|
* @see Uses locale conversion to allow decimal point to be locale specific.
|
|
* @see http://www.php.net/manual/en/function.localeconv.php
|
|
*
|
|
* @param string input string
|
|
* @return boolean
|
|
*/
|
|
public static function numeric($str)
|
|
{
|
|
// Use localeconv to set the decimal_point value: Usually a comma or period.
|
|
$locale = localeconv();
|
|
return (bool) preg_match('/^-?[0-9'.$locale['decimal_point'].']++$/D', (string) $str);
|
|
}
|
|
|
|
/**
|
|
* Tests if a number is within a range.
|
|
*
|
|
* @param integer number to check
|
|
* @param array valid range of input
|
|
* @return boolean
|
|
*/
|
|
public static function range($number, array $range)
|
|
{
|
|
// Invalid by default
|
|
$status = FALSE;
|
|
|
|
if (is_int($number) OR ctype_digit($number))
|
|
{
|
|
if (count($range) > 1)
|
|
{
|
|
if ($number >= $range[0] AND $number <= $range[1])
|
|
{
|
|
// Number is within the required range
|
|
$status = TRUE;
|
|
}
|
|
}
|
|
elseif ($number >= $range[0])
|
|
{
|
|
// Number is greater than the minimum
|
|
$status = TRUE;
|
|
}
|
|
}
|
|
|
|
return $status;
|
|
}
|
|
|
|
/**
|
|
* Checks if a string is a proper decimal format. The format array can be
|
|
* used to specify a decimal length, or a number and decimal length, eg:
|
|
* array(2) would force the number to have 2 decimal places, array(4,2)
|
|
* would force the number to have 4 digits and 2 decimal places.
|
|
*
|
|
* @param string input string
|
|
* @param array decimal format: y or x,y
|
|
* @return boolean
|
|
*/
|
|
public static function decimal($str, $format = NULL)
|
|
{
|
|
// Create the pattern
|
|
$pattern = '/^[0-9]%s\.[0-9]%s$/';
|
|
|
|
if ( ! empty($format))
|
|
{
|
|
if (count($format) > 1)
|
|
{
|
|
// Use the format for number and decimal length
|
|
$pattern = sprintf($pattern, '{'.$format[0].'}', '{'.$format[1].'}');
|
|
}
|
|
elseif (count($format) > 0)
|
|
{
|
|
// Use the format as decimal length
|
|
$pattern = sprintf($pattern, '+', '{'.$format[0].'}');
|
|
}
|
|
}
|
|
else
|
|
{
|
|
// No format
|
|
$pattern = sprintf($pattern, '+', '+');
|
|
}
|
|
|
|
return (bool) preg_match($pattern, (string) $str);
|
|
}
|
|
|
|
/**
|
|
* Checks if a string is a proper hexadecimal HTML color value. The validation
|
|
* is quite flexible as it does not require an initial "#" and also allows for
|
|
* the short notation using only three instead of six hexadecimal characters.
|
|
* You may want to normalize these values with format::color().
|
|
*
|
|
* @param string input string
|
|
* @return boolean
|
|
*/
|
|
public static function color($str)
|
|
{
|
|
return (bool) preg_match('/^#?+[0-9a-f]{3}(?:[0-9a-f]{3})?$/iD', $str);
|
|
}
|
|
|
|
final private function __construct()
|
|
{
|
|
// This is a static class
|
|
}
|
|
|
|
} // End valid
|