http://www.w3school.com.cn/php/php_filter.asp
http://www.w3school.com.cn/php/php_ref_filter.asp
过滤器函数分两种: 指定变量过滤 filter_var()、 filter_var_array(); 输入变量过滤 filter_input、 filter_input_array 有两种过滤器: Validating 过滤器,用于验证用户输入; Sanitizing 过滤器,用于允许或禁止字符串中指定的字符
函数
如需过滤变量,请使用下面的过滤器函数之一:
- filter_var() – 通过一个指定的过滤器来过滤单一的变量
- filter_var_array() – 通过相同的或不同的过滤器来过滤多个变量
- filter_input – 获取一个输入变量,并对它进行过滤
- filter_input_array – 获取多个输入变量,并通过相同的或不同的过滤器对它们进行过滤
- filter_has_var() – 检查是否存在指定输入类型的变量
- filter_list() – 返回包含所有得到支持的过滤器的一个数组
- filter_id() – 返回指定过滤器的 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 地址来验证。
Validating 和 Sanitizing
有两种过滤器:
Validating 过滤器:
- 用于验证用户输入
- 严格的格式规则(比如 URL 或 E-Mail 验证)
- 返回若成功预期的类型,否则返回 FALSE
Sanitizing 过滤器:
- 用于允许或禁止字符串中指定的字符
- 无数据格式规则
- 始终返回字符串
使用方法
filter_var() 函数
<?php $int = 123; if(!filter_var($int, FILTER_VALIDATE_INT)) { echo("Integer is not valid"); } else { echo("Integer is valid"); } ?>
选项和标志
在下面的例子中,我们用 filter_var() 和 “min_range” 以及 “max_range” 选项验证了一个整数:
<?php $var=300; $int_options = array( "options"=>array ( "min_range"=>0, "max_range"=>256 ) ); if(!filter_var($var, FILTER_VALIDATE_INT, $int_options)) { echo("Integer is not valid"); } else { echo("Integer is valid"); } ?>
验证输入
<?php if(!filter_has_var(INPUT_GET, "email")) { echo("Input type does not exist"); } else { if (!filter_input(INPUT_GET, "email", FILTER_VALIDATE_EMAIL)) { echo "E-Mail is not valid"; } else { echo "E-Mail is valid"; } } ?>
例子解释:
上面的例子有一个通过 “GET” 方法传送的输入变量 (email):
- 检测是否存在 “GET” 类型的 “email” 输入变量
- 如果存在输入变量,检测它是否是有效的邮件地址
净化输入
<?php if(!filter_has_var(INPUT_POST, "url")) { echo("Input type does not exist"); } else { $url = filter_input(INPUT_POST, "url", FILTER_SANITIZE_URL); } ?>
例子解释:
上面的例子有一个通过 “POST” 方法传送的输入变量 (url):
- 检测是否存在 “POST” 类型的 “url” 输入变量
- 如果存在此输入变量,对其进行净化(删除非法字符),并将其存储在 $url 变量中
过滤多个输入
<?php $filters = array ( "name" => array ( "filter"=>FILTER_SANITIZE_STRING ), "age" => array ( "filter"=>FILTER_VALIDATE_INT, "options"=>array ( "min_range"=>1, "max_range"=>120 ) ), "email"=> FILTER_VALIDATE_EMAIL, ); $result = filter_input_array(INPUT_GET, $filters); if (!$result["age"]) { echo("Age must be a number between 1 and 120.<br />"); } elseif(!$result["email"]) { echo("E-Mail is not valid.<br />"); } else { echo("User input is valid"); } ?>
例子解释:
上面的例子有三个通过 “GET” 方法传送的输入变量 (name, age and email)
- 设置一个数组,其中包含了输入变量的名称,以及用于指定的输入变量的过滤器
- 调用 filter_input_array 函数,参数包括 GET 输入变量及刚才设置的数组
- 检测 $result 变量中的 “age” 和 “email” 变量是否有非法的输入。(如果存在非法输入,)
使用 Filter Callback
<?php function convertSpace($string) { return str_replace("_", " ", $string); } $string = "Peter_is_a_great_guy!"; echo filter_var($string, FILTER_CALLBACK, array("options"=>"convertSpace")); ?>
例子解释:
上面的例子把所有 “_” 转换成空格:
- 创建一个把 “_” 替换为空格的函数
- 调用 filter_var() 函数,它的参数是 FILTER_CALLBACK 过滤器以及包含我们的函数的数组