Validation Class Reference
[Lib]

Validate several values. More...

List of all members.

Static Public Member Functions
static	is_domain ($value)
	Check if string is s domai name.
static	is_double ($value, $min=false, $max=false)
	Check if value is a double within given range.
static	is_email ($value)
	Check if value is a valid e-mail address.
static	is_int ($value, $min=false, $max=false)
	Check if value is a int within given range.
static	is_ip (&$ip)
	Check if given string is either a IPv4 or IPv6.
static	is_ip4 (&$ip)
	Check if $ip is a valid IPv4 address in dotted decimal format.
static	is_ip6 ($ip)
	Checks if given string is an IPv6.
static	is_string_of_length ($value, $min_length=0, $max_length=-1)
	Check if value is a string and validate its length.
static	is_url ($value)
	Check if value is an url.

---

Detailed Description

Validate several values.

Todo:

Can be transformed into an adapter to filter extension with PHP 5.2

Author:

Gerd Riesselmann

Definition at line 10 of file validation.cls.php.

---

Member Function Documentation

static Validation::is_domain

(

$

value

)

[static]

Check if string is s domai name.

Does not check for valid TLD, use Url validation for that

Definition at line 39 of file validation.cls.php.

                                                 {
                $ret = true;
                $ret = $ret && (strlen($value) <= 255);
                
                $elements = explode('.', $value);
                $ret = $ret && (count($elements) > 1);

                // Check elements
                foreach($elements as $e) {
                        $l = strlen($e);
                        $ret = $ret && ($l > 0);
                        $ret = $ret && ($l <= 63);
                        $ret = $ret && preg_match('|^[^@ ]+$|', $e);
                }  
                
                // Check TLD
                $tld = array_pop($elements);
                $ret = $ret && !preg_match('|^\d+$|', $tld); // TLD not only numbers 
                
                return $ret;
        }

static Validation::is_double	(	$	value,
		$	min = false,
		$	max = false
	)			[static]

Check if value is a double within given range.

Parameters:

	mixed	The value to check
	mixed	Min value or false to not check for min value
	mixed	Max value or false to not check for max value

Definition at line 95 of file validation.cls.php.

                                                                             {
                $ret = is_numeric($value);
                if ($ret) {
                        $value = Cast::float($value);
                        if ($min !== false) {
                                $ret = $ret && ($value >= $min);
                        }
                        if ($max !== false) {
                                $ret = $ret && ($value <= $max);
                        }
                }
                return $ret;
        }

static Validation::is_email

(

$

value

)

[static]

Check if value is a valid e-mail address.

Definition at line 14 of file validation.cls.php.

                                                {
                $parts = explode('@', $value, 2);
                $local_part = array_shift($parts);
                $domain = array_shift($parts);
                
                $ret = self::is_domain($domain);
                // local part may be up to 64 characters 
                $ret = $ret && (strlen($local_part) <= 64);
                // dot is not allowed at the end or beginning
                // There is also a rule that 2 or more dots are illegal like in 'forname..lastname@web.de'
                // Unfortunately: my neighbor's address IS forname..lastname@web.de! And I can't lock my neighbor 
                // out of the services I program, can I? 
                $ret = $ret && (substr($local_part, 0, 1) !== '.');
                $ret = $ret && (substr($local_part, -1) !== '.');
                // Only a-z, A-Z, 0-9 and !#$%&'*+-/=?^_`{|}~ and . are allowed
                // (There is quoting and escaping, but we do not hear, we do not hear, we do not hear...)
                $pattern = "@^[a-zA-Z0-9!#$%&'*+\-/=?^_`{|}~.]+$@s";
                $ret = $ret && preg_match($pattern, strtr($local_part, "\r\n", '  '));
                
                return $ret;
        }

static Validation::is_int	(	$	value,
		$	min = false,
		$	max = false
	)			[static]

Check if value is a int within given range.

Parameters:

	mixed	The value to check
	mixed	Min value or false to not check for min value
	mixed	Max value or false to not check for max value

Returns:

bool

Definition at line 117 of file validation.cls.php.

                                                                          {
                $ret = ($value == strval(intval($value)));
                if ($ret) {
                        $value = Cast::int($value);
                        if ($min !== false) {
                                $ret = $ret && ($value >= $min);
                        }
                        if ($max !== false) {
                                $ret = $ret && ($value <= $max);
                        }
                }
                return $ret;
        }

static Validation::is_ip

(

&$

ip

)

[static]

Check if given string is either a IPv4 or IPv6.

Definition at line 190 of file validation.cls.php.

                                           {
                return self::is_ip4($ip) || self::is_ip6($ip);
        }

static Validation::is_ip4

(

&$

ip

)

[static]

Check if $ip is a valid IPv4 address in dotted decimal format.

If the validation succeeds, the given string is replaced by a _very_ well formatted version, that will even pass tests that check for 3 digits

Example: 192.0168.1.2 is valid, but a lot of IP tests will fail because of 0168. This function will pass, and set $ip to 192.168.1.2

Attention:

Note that Octal, Hexadecimal, Decimal, Dotted Hexadecimal and Dotted Octal are not supported. They are rarely used, though

Definition at line 143 of file validation.cls.php.

                                            {
                // Using filter_var here fails in recognizing 255.255.255.0255 as a valid IP
                // See http://en.wikipedia.org/wiki/IPv4#Address_representations
                $test = explode('.', $ip);
                $ints = array();
                $ret = (count($test) == 4);
                foreach($test as $datum) {
                        $ret = $ret && self::is_int($datum, 0, 255);
                        if ($ret) { $ints[] = intval($datum); }
                }       
                
                $regex = '@^[0.]*$@'; // Contains only ., and 0
                $ret = $ret && !preg_match($regex, $ip);
                
                if ($ret) {
                        $ip = implode('.', $ints);
                }

                return $ret;
        }

static Validation::is_ip6

(

$

ip

)

[static]

Checks if given string is an IPv6.

Definition at line 167 of file validation.cls.php.

                                           {
                $ret = false;
                if (function_exists('filter_var')) {
                        // This regards :: as valid, also ::0 or ::0.0.0.0 as OK, which is wrong
                        $ret = filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV6);
                }
                else {
                        // This regards :: as invalid, but ::0 or ::0.0.0.0 as OK, which is wrong
                        // Taken from here: http://regexlib.com/REDetails.aspx?regexp_id=1000
                        $regex = "@^((([0-9A-Fa-f]{1,4}:){7}[0-9A-Fa-f]{1,4})|(([0-9A-Fa-f]{1,4}:){6}:[0-9A-Fa-f]{1,4})|(([0-9A-Fa-f]{1,4}:){5}:([0-9A-Fa-f]{1,4}:)?[0-9A-Fa-f]{1,4})|(([0-9A-Fa-f]{1,4}:){4}:([0-9A-Fa-f]{1,4}:){0,2}[0-9A-Fa-f]{1,4})|(([0-9A-Fa-f]{1,4}:){3}:([0-9A-Fa-f]{1,4}:){0,3}[0-9A-Fa-f]{1,4})|(([0-9A-Fa-f]{1,4}:){2}:([0-9A-Fa-f]{1,4}:){0,4}[0-9A-Fa-f]{1,4})|(([0-9A-Fa-f]{1,4}:){6}((\b((25[0-5])|(1\d{2})|(2[0-4]\d)|(\d{1,2}))\b)\.){3}(\b((25[0-5])|(1\d{2})|(2[0-4]\d)|(\d{1,2}))\b))|(([0-9A-Fa-f]{1,4}:){1,5}:((\b((25[0-5])|(1\d{2})|(2[0-4]\d)|(\d{1,2}))\b)\.){3}(\b((25[0-5])|(1\d{2})|(2[0-4]\d)|(\d{1,2}))\b))|(([0-9A-Fa-f]{1,4}:){1}:([0-9A-Fa-f]{1,4}:){0,4}((\b((25[0-5])|(1\d{2})|(2[0-4]\d)|(\d{1,2}))\b)\.){3}(\b((25[0-5])|(1\d{2})|(2[0-4]\d)|(\d{1,2}))\b))|(([0-9A-Fa-f]{1,4}:){0,2}:([0-9A-Fa-f]{1,4}:){0,3}((\b((25[0-5])|(1\d{2})|(2[0-4]\d)|(\d{1,2}))\b)\.){3}(\b((25[0-5])|(1\d{2})|(2[0-4]\d)|(\d{1,2}))\b))|(([0-9A-Fa-f]{1,4}:){0,3}:([0-9A-Fa-f]{1,4}:){0,2}((\b((25[0-5])|(1\d{2})|(2[0-4]\d)|(\d{1,2}))\b)\.){3}(\b((25[0-5])|(1\d{2})|(2[0-4]\d)|(\d{1,2}))\b))|(([0-9A-Fa-f]{1,4}:){0,4}:([0-9A-Fa-f]{1,4}:){1}((\b((25[0-5])|(1\d{2})|(2[0-4]\d)|(\d{1,2}))\b)\.){3}(\b((25[0-5])|(1\d{2})|(2[0-4]\d)|(\d{1,2}))\b))|(::([0-9A-Fa-f]{1,4}:){0,5}((\b((25[0-5])|(1\d{2})|(2[0-4]\d)|(\d{1,2}))\b)\.){3}(\b((25[0-5])|(1\d{2})|(2[0-4]\d)|(\d{1,2}))\b))|([0-9A-Fa-f]{1,4}::([0-9A-Fa-f]{1,4}:){0,5}[0-9A-Fa-f]{1,4})|(::([0-9A-Fa-f]{1,4}:){0,6}[0-9A-Fa-f]{1,4})|(([0-9A-Fa-f]{1,4}:){1,7}:))$@";
                        $ret = preg_match($regex, $ip);
                }       
                if ($ret) {
                        // :: in any combination (::, ::0, 0::0:0.0.0.0) is invalid!
                        $regex = '@^[0.:]*$@'; // Contains only ., :, and 0
                        $ret = !preg_match($regex, $ip);
                }
                return $ret;
        }

static Validation::is_string_of_length	(	$	value,
		$	min_length = 0,
		$	max_length = -1
	)			[static]

Check if value is a string and validate its length.

Parameters:

Definition at line 66 of file validation.cls.php.

                                                                                              {
                if (is_null($value)) {
                        $value = '';
                }
                $ret = is_string($value);
                if ($ret) {
                        $ret = $ret && ( String::length($value) >= $min_length);
                        if ($max_length > 0) {
                                $ret = $ret && ( String::length($value) <= $max_length); 
                        } 
                }
                return $ret;
        }

static Validation::is_url

(

$

value

)

[static]

Check if value is an url.

Definition at line 83 of file validation.cls.php.

                                              {
                $test = new Url($value);
                return $test->is_valid();
        }

---

The documentation for this class was generated from the following file:

• gyro/core/lib/helpers/validation.cls.php