PHP过滤器包含两种类型
- Validation：用来验证验证项是否合法
- Sanitization：用来格式化被验证的项目，因此它可能会修改验证项的值，将不合法的字符删除等。
input_filters_list()
用来列出当前系统所支持的所有过滤器。
|
1
2
3
4
5
6
|
<?phpforeach(filter_list() as $id => $filter){ echo $filter.' '.filter_id($filter)."
";}?> |
以上代码会输出如下信息
| Filter Name | Filter ID |
|---|---|
| int | 257 |
| boolean | 258 |
| float | 259 |
| validate_regexp | 272 |
| validate_url | 273 |
| validate_email | 274 |
| validate_ip | 275 |
| string | 513 |
| stripped | 513 |
| encoded | 514 |
| special_chars | 515 |
| full_special_chars | 522 |
| unsafe_raw | 516 |
| 517 | |
| url | 518 |
| number_int | 519 |
| number_float | 520 |
| magic_quotes | 521 |
| callback | 1024 |
每个过滤器都会拥有一个独自的ID。这里的每个过滤器都能够被filter_var()函数使用。下面将会逐个介绍其使用方法。注意 ，上面的string和strippedID相同，这是因为他们是同一个过滤器，或者说是同一个过滤器的两个别名罢了。
过滤数据
使用filter_var()方法对数据进行过滤，下面是一个简单的过滤例子
|
1
2
3
4
5
6
7
8
|
<?php/*** an integer to check ***/$int = 1234;/*** validate the integer ***/echo filter_var($int, FILTER_VALIDATE_INT);//1234?> |
上面代码将会数据一个整数型的1234，因为$int变量通过的整数类型的验证，这次更换一下$int变量的内容
|
1
2
3
4
5
6
7
|
<?php/*** an integer to check ***/$int = 'abc1234';/*** validate the integer ***/echo filter_var($int, FILTER_VALIDATE_INT);?> |
此时在运行代码，发现没有任何变量输出，这是因为$in变量没有通过验证，因此这个方法返回bool(false)。同时也需要注意 一下，即使$int=”，也会返回bool(false)
整数验证
上面的几段代码简单的验证了一个给定值是否为整数的例子。其实FILTER_VALIDATE_INT也提供了数值范围的验证，下面我们 来验证一个变量，判断它是否为整数型，并验证它的值是否在50到100之间
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
|
<?php/*** an integer to check ***/$int = 42;/*** lower limit of the int ***/$min = 50;/*** upper limit of the int ***/$max = 100;/*** validate the integer ***/echo filter_var($int, FILTER_VALIDATE_INT, array("min_range" => $min, "max_range" => $max));//42?> |
运行上面的代码，发现42被输出来了，并没有发现任何错误,这是为什么啊？原来想要向验证中添加附加验证规则时候，需要传递一个含有’options‘键的数组，向下面这样：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
|
<?php/*** an integer to check ***/$int = 42;/*** lower limit of the int ***/$min = 50;/*** upper limit of the int ***/$max = 100;/*** validate the integer ***/echo filter_var($int, FILTER_VALIDATE_INT, array("options" => array("min_range" => $min, "max_range" => $max)));?> |
运行上面的代码，页面不会有任何输出，因为上面返回了false，说明验证成功。
- 使用该方法也可以对负数进行范围验证
- 同时这种方式也支持单范围取值，即只是指定一个最大值或者最小值的范围，如：
|
1
2
3
4
5
6
7
8
9
10
11
|
<?php/*** an integer to check ***/$int = 12;/*** lower limit of the int ***/$min = 10;/*** validate the integer ***/echo filter_var($int, FILTER_VALIDATE_INT,array('options' => array('min_range' => $min)));//12?> |
上述代码会验证$int是否是大于(不包括等于)$min的整数类型的值,运行代码，输出12
对一组变量进行验证
上面的这些例子只是简单的对单个值进行验证，那么如果对一组变量进行验证呢？答案是使用filter_var_array()。该函数可以同时验证多个不同类型的数据。这里先做一个简单的例子：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
|
<?php/*** an array of values to filter ***/$arr = array(10,"109","", "-1234", "some text", "asdf234asdfgs", array());/*** create an array of filtered values ***/$filtered_array = filter_var_array($arr, FILTER_VALIDATE_INT);/*** print out the results ***/foreach($filtered_array as $key => $value){ echo $key.' -- '.$value.'<br />';}?> |
运行上述代码，输出如下：
0 -- 10 1 -- 109 2 -- 3 -- -1234 4 -- 5 -- 6 -- Array
八进制和十六进制
FILTER_VALIDATE_INT过滤器同时支持八进制和十六进制，这两种flags是：
- FILTER_FLAG_ALLOW_HEX
- FILTER_FLAG_ALLOW_OCTAL
利用数组传递flags
|
1
2
3
4
5
6
7
8
|
<?php/*** a hex value to check ***/$hex = "0xff";/*** filter with HEX flag ***/echo filter_var($hex, FILTER_VALIDATE_INT, array("flags" => FILTER_FLAG_ALLOW_HEX));//255?> |
Boolean验证 FILTER_VALIDATE_BOOLEAN
|
1
2
3
4
5
|
<?php/*** test for a boolean value ***/echo filter_var("true", FILTER_VALIDATE_BOOLEAN);//1?> |
上面的代码输出1，因为过滤器发现了一个有效的布尔值，下面列出了其它可以返回true的值
- 1
- “1”
- “yes”
- “true”
- “on”
- TRUE
下列值将会返回false
- 0
- “0”
- “no”
- “false”
- “off”
- “”
- NULL
- FALSE
同时也支持下面的用法
|
1
2
3
4
5
6
7
8
|
<?php/*** a simple array ***/$array = array(1,2,3,4,5);/*** test for a boolean value ***/echo filter_var(in_array(3, $array), FILTER_VALIDATE_BOOLEAN) ? "TRUE" : "FALSE";//true?> |
在上面的代码中，先判断了in_array函数执行成功，返回了true，所以最后这段代码输出true
我们也可以传递一个数组，来判断数组中值的boolean类型
|
1
2
3
4
5
6
7
8
9
10
|
<?php/*** a multi dimensional array ***/$array = array(0, 1, 2, 3, 4, array(0, 1, 2, 3, 4));/*** create the list of values ***/$values = filter_var($array, FILTER_VALIDATE_BOOLEAN, FILTER_REQUIRE_ARRAY);/*** dump the values ***/var_dump($values);?> |
上面代码输出如下：
array(6) {
[0] => bool(false)
[1] => bool(true)
[2] => bool(false)
[3] => bool(false)
[4] => bool(false)
[5] => array(5) {
[0] => bool(false)
[1] => bool(true)
[2] => bool(false)
[3] => bool(false)
[4] => bool(false)
}
}
浮点型验证 FILTER_VALIDATE_FLOAT
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
|
<?php/*** an FLOAT value to check ***/$float = 22.42;/*** validate with the FLOAT flag ***/if(filter_var($float, FILTER_VALIDATE_FLOAT) === false){ echo "$float is not valid!";}else{ echo "$float is a valid floating point number";}?> |
对数组进行浮点型验证
同其它验证一样，也可以对一个数组进行浮点型验证。与boolean验证类似，提供一个flgs FILTER_REQUIRE_ARRAY。
|
1
2
3
4
5
6
7
8
9
10
|
<?php/*** an array of values ***/$array = array(1.2,"1.7","", "-12345.678", "some text", "abcd4.2efgh", array());/*** validate the array ***/$validation_array = filter_var($array, FILTER_VALIDATE_FLOAT, FILTER_REQUIRE_ARRAY);/*** dump the array of validated data ***/var_dump($validation_array);?> |
上面的代码输出如下
array(7) {
[0] => float(1.2)
[1] => float(1.7)
[2] => bool(false)
[3] => float(-23234.123)
[4] => bool(false)
[5] => bool(false)
[6] => array(0) { }
}
浮点型过滤器支持我们指定一个数字间的分隔符
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
|
<?php/*** an array of floats with seperators ***/$floats = array( "1,234" => ",", "1.234" => "..", "1.2e3" => ",");/*** validate the floats against the user defined decimal seperators ***/foreach ($floats as $float => $dec_sep){ $out = filter_var($float, FILTER_VALIDATE_FLOAT, array("options" => array("decimal" => $dec_sep))); /*** dump the results ***/ var_dump($out);}?> |
在上面的代码中，$floats函数中第一个元素值为’,’，所以在判断1,234值时为其指定了分隔符为’,’，所以返回true
上面代码完整返回值
float(1.234) Warning: filter_var() [function.filter-var]: decimal separator must be one char in /www/filter.php on line 13 bool(false) bool(false)
验证URL FILTER_VALIDATE_URL
URL的验证是一项很困难的行为，由于 URL的不确定性，它没有最大长度的限制，而且它的格式是多样化的，你可以通过阅读RFC 1738来了解有关URL的一些信息。之后你可以创建一个类来验证所有ipv4和ipv6的URL，以及一些其它URL的验证。你也可以简单的使用 FILTER_VALIDATE_URL来验证URL。
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
|
<?php/*** a rfc compliant web address ***/$url = "http://www.phpro.org";/*** try to validate the URL ***/if(filter_var($url, FILTER_VALIDATE_URL) === FALSE){ /*** if there is no match ***/ echo "Sorry, $url is not valid!";}else{ /*** if we match the pattern ***/ echo "The URL, $url is valid!<br />";}?> |
上面的例子中通过简单的if语句来判断给定的URL是否合法，但并不是所有的URL都是这样的格式。有时候URL可是能是一个IP地址，也可能在URL中传递了多个参数。下面提供了几个flags来帮助我们验证URL：
- FILTER_FLAG_SCHEME_REQUIRED – 要求 URL 是 RFC 兼容 URL。（比如：http://yii.so）
- FILTER_FLAG_HOST_REQUIRED – 要求 URL 包含主机名（比如：http://levi.cg.com）
- FILTER_FLAG_PATH_REQUIRED – 要求 URL 在主机名后存在路径（比如：http://levi.yii.so/test/phpmailer/）
- FILTER_FLAG_QUERY_REQUIRED – 要求 URL 存在查询字符串（比如：http://levi.yii.so/?p=2618）
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
|
<?php/*** a non rfc compliant URL ***/$url = "index.php";/*** try to validate the URL ***/if(filter_var($url, FILTER_VALIDATE_URL, FILTER_FLAG_SCHEME_REQUIRED) === FALSE){ /*** if there is no match ***/ echo "Sorry, $url is not valid!";}else{ /*** if the URL is valid ***/ echo "The URL, $url is valid!";}?> |
可以发现，上面的代码没有通过验证
IP过滤器 FILTER_VALIDATE_IP
FILTER_VALIDATE_IP 过滤器把值作为 IP 进行验证。
Name: “validate_ip”
ID-number: 275
可能的标志：
- FILTER_FLAG_IPV4 – 要求值是合法的 IPv4 IP（比如：255.255.255.255）
- FILTER_FLAG_IPV6 – 要求值是合法的 IPv6 IP（比如：2001:0db8:85a3:08d3:1319:8a2e:0370:7334）
- FILTER_FLAG_NO_PRIV_RANGE – 要求值是 RFC 指定的私域 IP （比如 192.168.0.1）
- FILTER_FLAG_NO_RES_RANGE – 要求值不在保留的 IP 范围内。该标志接受 IPV4 和 IPV6 值。
Email过滤器FILTER_VALIDATE_EMAIL
FILTER_VALIDATE_EMAIL 过滤器把值作为电子邮件地址来验证。
|
1
2
3
4
5
6
7
8
9
10
11
12
|
<?php$email = "someone@exa mple.com";if(!filter_var($email, FILTER_VALIDATE_EMAIL)){ echo "E-mail is not valid";}else{ echo "E-mail is valid";}?> |
自定义过滤器 FILTER_CALLBACK
FILTER_CALLBACK 过滤器使用用户自定义函数对值进行过滤。
这个过滤器为我们提供了对数据过滤的完全控制。
指定的函数必须存入名为 “options” 的关联数组中。
|
1
2
3
4
5
6
7
8
9
10
11
|
<?phpfunction convertSpace($string){ return str_replace(" ", "_", $string);}$string = "Peter is a great guy!";echo filter_var($string, FILTER_CALLBACK, array("options" => "convertSpace"));?> |
输出
Peter_is_a_great_guy!
PHP Filter 函数
PHP：指示支持该函数的最早的 PHP 版本。
| 函数 | 描述 | PHP |
|---|---|---|
| filter_has_var() | 检查是否存在指定输入类型的变量。 | 5 |
| filter_id() | 返回指定过滤器的 ID 号。 | 5 |
| filter_input() | 从脚本外部获取输入，并进行过滤。 | 5 |
| filter_input_array() | 从脚本外部获取多项输入，并进行过滤。 | 5 |
| filter_list() | 返回包含所有得到支持的过滤器的一个数组。 | 5 |
| filter_var_array() | 获取多项变量，并进行过滤。 | 5 |
| filter_var() | 获取一个变量，并进行过滤。 | 5 |
PHP Filters
| ID 名称 | 描述 |
|---|---|
| FILTER_CALLBACK | 调用用户自定义函数来过滤数据。 |
| FILTER_SANITIZE_STRING | 去除标签，去除或编码特殊字符。 |
| FILTER_SANITIZE_STRIPPED | “string” 过滤器的别名。 |
| FILTER_SANITIZE_ENCODED | URL-encode 字符串，去除或编码特殊字符。 |
| FILTER_SANITIZE_SPECIAL_CHARS | HTML 转义字符 ‘”<>& 以及 ASCII 值小于 32 的字符。 |
| FILTER_SANITIZE_EMAIL | 删除所有字符，除了字母、数字以及 !#$%&’*+-/=?^_`{|}~@.[] |
| FILTER_SANITIZE_URL | 删除所有字符，除了字母、数字以及 $-_.+!*'(),{}|//^~[]`<>#%”;/?:@&= |
| FILTER_SANITIZE_NUMBER_INT | 删除所有字符，除了数字和 +- |
| FILTER_SANITIZE_NUMBER_FLOAT | 删除所有字符，除了数字、+- 以及 .,eE。 |
| FILTER_SANITIZE_MAGIC_QUOTES | 应用 addslashes()。 |
| FILTER_UNSAFE_RAW | 不进行任何过滤，去除或编码特殊字符。 |
| FILTER_VALIDATE_INT | 在指定的范围以整数验证值。 |
| FILTER_VALIDATE_BOOLEAN | 如果是 “1”, “true”, “on” 以及 “yes”，则返回 true，如果是 “0”, “false”, “off”, “no” 以及 “”，则返回 false。否则返回 NULL。 |
| FILTER_VALIDATE_FLOAT | 以浮点数验证值。 |
| FILTER_VALIDATE_REGEXP | 根据 regexp，兼容 Perl 的正则表达式来验证值。 |
| FILTER_VALIDATE_URL | 把值作为 URL 来验证。 |
| FILTER_VALIDATE_EMAIL | 把值作为 e-mail 来验证。 |
| FILTER_VALIDATE_IP | 把值作为 IP 地址来验证 |
Sanitize filters
| ID (过滤器常量) | 名称 (filter_list()函数返回的名称) | 可用选项 | 标志位 | 描述 |
|---|---|---|---|---|
| Validating | ||||
| FILTER_VALIDATE_BOOLEAN | “boolean” | FILTER_NULL_ON_FAILURE | 当 难的数据为”1″,”true”,”on”,”yes”时返回true，否则返回false。当设置了FILTER_NULL_ON_FAILURE标志 位，则仅在值是”0″,”false”,”off”,”no”, 和””是返回false，其它非true值返回null。 | |
| FILTER_VALIDATE_EMAIL | “validate_email” | 验证邮箱 | ||
| FILTER_VALIDATE_FLOAT | “float” | decimal | FILTER_FLAG_ALLOW_THOUSAND | 验证浮点数 |
| FILTER_VALIDATE_INT | “int” | min_range, max_range | FILTER_FLAG_ALLOW_OCTAL, FILTER_FLAG_ALLOW_HEX | 验证一个指定范围内的整数值 |
| FILTER_VALIDATE_IP | “validate_ip” | FILTER_FLAG_IPV4, FILTER_FLAG_IPV6, FILTER_FLAG_NO_PRIV_RANGE, FILTER_FLAG_NO_RES_RANGE | 验证IP地址 | |
| FILTER_VALIDATE_REGEXP | “validate_regexp” | regexp | 验证一个正则表达式 | |
| FILTER_VALIDATE_URL | “validate_url” | FILTER_FLAG_PATH_REQUIRED, FILTER_FLAG_QUERY_REQUIRED | 验证一个URL | |
| Sanitizing | ||||
| FILTER_SANITIZE_EMAIL | “email” | 移除除英文字符，数字以及!#$%&’*+-/=?^_`{|}~@.[]之外的字符。 | ||
| FILTER_SANITIZE_ENCODED | “encoded” | FILTER_FLAG_STRIP_LOW, FILTER_FLAG_STRIP_HIGH, FILTER_FLAG_ENCODE_LOW, FILTER_FLAG_ENCODE_HIGH | URL编码字符串，去除或编码指定字符串。 | |
| FILTER_SANITIZE_MAGIC_QUOTES | “magic_quotes” | 应用 addslashes()函数 | ||
| FILTER_SANITIZE_NUMBER_FLOAT | “number_float” | FILTER_FLAG_ALLOW_FRACTION, FILTER_FLAG_ALLOW_THOUSAND, FILTER_FLAG_ALLOW_SCIENTIFIC | 移除除数字，+-以及.,eE以外的字符 | |
| FILTER_SANITIZE_NUMBER_INT | “number_int” | 移除除数字以及+-以外的字符 | ||
| FILTER_SANITIZE_SPECIAL_CHARS | “special_chars” | FILTER_FLAG_STRIP_LOW, FILTER_FLAG_STRIP_HIGH, FILTER_FLAG_ENCODE_HIGH | HTML转义字符，'”&><以及 ASCII 值小于 32 的字符。以及其它指定的字符。 | |
| FILTER_SANITIZE_STRING | “string” | FILTER_FLAG_NO_ENCODE_QUOTES, FILTER_FLAG_STRIP_LOW, FILTER_FLAG_STRIP_HIGH, FILTER_FLAG_ENCODE_LOW, FILTER_FLAG_ENCODE_HIGH, FILTER_FLAG_ENCODE_AMP | 去除标签，或是去除或编码指定的字符。 | |
| FILTER_SANITIZE_STRIPPED | “stripped” | Alias of “string” filter. | ||
| FILTER_SANITIZE_URL | “url” | 删除所有字符除字母、数字以及$-_.+!*'(),{}|\^~[]`<>#%”;/?:@&= | ||
| FILTER_UNSAFE_RAW | “unsafe_raw” | FILTER_FLAG_STRIP_LOW, FILTER_FLAG_STRIP_HIGH, FILTER_FLAG_ENCODE_LOW, FILTER_FLAG_ENCODE_HIGH, FILTER_FLAG_ENCODE_AMP | 不做任何改变，或是按标志位去除或是编码指定字母。 | |
| FILTER_CALLBACK | “callback” | FILTER_FLAG_STRIP_LOW, FILTER_FLAG_STRIP_HIGH, FILTER_FLAG_ENCODE_LOW, FILTER_FLAG_ENCODE_HIGH, FILTER_FLAG_ENCODE_AMP | ||