|
概述 正如你所见到的一样,I方法是ThinkPHP众多单字母函数中的新成员,其命名来自于英文Input(输入),主要用于更加方便和安全的获取系统输入变量,可以用于任何地方,用法格式如下:( F# B" X6 H1 n' N f4 u$ w' M
I('变量类型.变量名',['默认值'],['过滤方法']): M, ^1 M+ ?6 |+ p! w& i( p
变量类型是指请求方式或者输入类型,包括:
( f4 \9 W- U$ F; N, j| 变量类型 | 含义 | | get | 获取GET参数 | | post | 获取POST参数 | | param | 自动判断请求类型获取GET、POST或者PUT参数 | | request | 获取REQUEST 参数 | | put | 获取PUT 参数 | | session | 获取 $_SESSION 参数 | | cookie | 获取 $_COOKIE 参数 | | server | 获取 $_SERVER 参数 | | globals | 获取 $GLOBALS参数 |
3 {* i- o2 [6 @7 i
注意:变量类型不区分大小写。 W, y# ^( Y. T( O [! ?* f/ {" ?
变量名则严格区分大小写。
9 W4 r: m2 O! @8 N默认值和过滤方法均属于可选参数。
! f/ `7 R; Q+ k8 d
& N/ A+ H `& k3 V 用法我们以GET变量类型为例,说明下I方法的使用: - echo I('get.id'); // 相当于 $_GET['id']
- echo I('get.name'); // 相当于 $_GET['name']+ Y, ^( X' s z
复制代码
4 Q* e2 P0 a* A% d支持默认值: - echo I('get.id',0); // 如果不存在$_GET['id'] 则返回0
- echo I('get.name',''); // 如果不存在$_GET['name'] 则返回空字符串
' h! B4 R' v' C+ L3 s6 V 复制代码
3 X' V# C. m# o# k/ G* h6 D+ @采用方法过滤: - echo I('get.name','','htmlspecialchars'); // 采用htmlspecialchars方法对$_GET['name'] 进行过滤,如果不存在则返回空字符串
! {) S; _% M5 p0 R3 a( F 复制代码# T0 b1 ]. V" `7 f5 J& j( _* l2 k
支持直接获取整个变量类型,例如: - I('get.'); // 获取整个$_GET 数组
$ r! G; s& T5 |4 S$ ]. T& d/ { 复制代码
" D; t9 l& i: E' Q用同样的方式,我们可以获取post或者其他输入类型的变量,例如: - I('post.name','','htmlspecialchars'); // 采用htmlspecialchars方法对$_POST['name'] 进行过滤,如果不存在则返回空字符串
- I('session.user_id',0); // 获取$_SESSION['user_id'] 如果不存在则默认为0
- I('cookie.'); // 获取整个 $_COOKIE 数组
- I('server.REQUEST_METHOD'); // 获取 $_SERVER['REQUEST_METHOD']
; r/ W1 h. T# e) i5 U! A 复制代码
+ ^: S$ m' c$ O6 }$ J: iparam变量类型是框架特有的支持自动判断当前请求类型的变量获取方式,例如: - echo I('param.id');; g1 k& g, N! f. y1 r
复制代码
; x% s+ n5 G0 u/ L, t如果当前请求类型是GET,那么等效于 $_GET['id'],如果当前请求类型是POST或者PUT,那么相当于获取 $_POST['id'] 或者 PUT参数id。
1 \3 ^* E2 Z. S) [并且param类型变量还可以用数字索引的方式获取URL参数(必须是PATHINFO模式参数有效,无论是GET还是POST方式都有效),例如:" [. R2 g% K& Z5 z$ R
当前访问URL地址是 - http://serverName/index.php/New/2013/06/01+ y' M# s* y2 a% S2 {8 N, i
复制代码" R6 I5 r# N: M7 T& k
那么我们可以通过 - echo I('param.1'); // 输出2013
- echo I('param.2'); // 输出06
- echo I('param.3'); // 输出01: d7 _. _0 L5 \) ~2 l U6 v5 x9 u- d
复制代码
$ ?! C- I/ a' s7 b5 \1 e) C8 O事实上,param变量类型的写法可以简化为: - I('id'); // 等同于 I('param.id')
- I('name'); // 等同于 I('param.name')
5 N4 c& O5 A" ?( v0 X8 X6 S 复制代码
9 k: ~. `3 Y9 P8 J; k( Z) r变量过滤使用I方法的时候 变量其实经过了两道过滤,首先是全局的过滤,全局过滤是通过配置VAR_FILTERS参数,这里一定要注意,3.1版本之后,VAR_FILTERS参数的过滤机制已经更改为采用array_walk_recursive方法递归过滤了,主要对过滤方法的要求是必须引用返回,所以这里设置htmlspecialchars是无效的,你可以自定义一个方法,例如: - function filter_default(&$value){
- $value = htmlspecialchars($value);
- }, ?9 h7 d% I. a- o% B
复制代码8 X4 A2 z1 `7 }3 @. K1 z
然后配置: - 'VAR_FILTERS'=>'filter_default'% j# `- @% [( Y$ \+ u; V
复制代码
) \$ J5 I" A/ X1 p4 O, y- p如果需要进行多次过滤,可以用: - 'VAR_FILTERS'=>'filter_default,filter_exp'; j+ H3 E( F7 t% t( c& r0 x6 f7 i
复制代码
/ u8 ]) H& K9 cfilter_exp方法是框架内置的安全过滤方法,用于防止利用模型的EXP功能进行注入攻击。
: n/ k: L% V8 X: z9 l) u- W6 Q
3 Y) s, o) P: t! E2 P5 ^% e8 |! k因为VAR_FILTERS参数设置的是全局过滤机制,而且采用的是递归过滤,对效率有所影响,所以,我们更建议直接对获取变量过滤的方式,除了在I方法的第三个参数设置过滤方法外,还可以采用配置DEFAULT_FILTER参数的方式设置过滤,事实上,该参数的默认设置是: - 'DEFAULT_FILTER' => 'htmlspecialchars'
* N% C' @* e' Z4 `# b2 p, W 复制代码
" {1 d$ {% n3 B4 L1 ]也就说,I方法的所有获取变量都会进行htmlspecialchars过滤,那么: - I('get.name'); // 等同于 htmlspecialchars($_GET['name'])
* l, S+ `/ B" p2 U- e! l 复制代码6 q. D# h% u J$ q
同样,该参数也可以支持多个过滤,例如: - 'DEFAULT_FILTER' => 'strip_tags,htmlspecialchars'
# l; ?* D+ T! D, m- ~ 复制代码1 q' s( j- d5 N& i. z
- I('get.name'); // 等同于 htmlspecialchars(strip_tags($_GET['name']))
8 ^% W, \8 \% m, S* E 复制代码) @$ _" q: C3 @, x, Z& `! ]
如果我们在使用I方法的时候 指定了过滤方法,那么就会忽略DEFAULT_FILTER的设置,例如: - echo I('get.name','','strip_tags'); // 等同于 strip_tags($_GET['name'])
# q: `7 t8 L1 B5 ]! ]( g( _& a& G0 @ 复制代码2 K9 @, U/ U, [% U! l0 r ^1 o& D' K
I方法的第三个参数如果传入函数名,则表示调用该函数对变量进行过滤并返回(在变量是数组的情况下自动使用array_map进行过滤处理),否则会调用PHP内置的filter_var方法进行过滤处理,例如: - I('post.email','',FILTER_VALIDATE_EMAIL);
. ~$ n5 a. s+ t/ g& j# [ 复制代码/ n0 E; u$ d, m w; b$ }
表示 会对$_POST['email'] 进行 格式验证,如果不符合要求的话,返回空字符串。1 U5 l \0 n, B# N/ F; a, |
(关于更多的验证格式,可以参考 官方手册的filter_var用法。), s b$ w. f/ {5 p4 T
或者可以用下面的字符标识方式: - I('post.email','','email');
0 I* D1 T/ V1 ^+ V; C. D 复制代码* k2 U) `- I9 N0 f( P5 d2 a
可以支持的过滤名称必须是filter_list方法中的有效值(不同的服务器环境可能有所不同),可能支持的包括: - int
- boolean
- float
- validate_regexp
- validate_url
- validate_email
- validate_ip
- string
- stripped
- encoded
- special_chars
- unsafe_raw
- email
- url
- number_int
- number_float
- magic_quotes
- callback) n- J# W1 K1 D; { X1 s
复制代码' Z4 j1 c5 R( r `6 P( f* U: E/ h# Y
在有些特殊的情况下,我们不希望进行任何过滤,即使DEFAULT_FILTER已经有所设置,可以使用: - I('get.name','',NULL);# O7 n( P& D1 d% A- U, t5 O- k
复制代码9 B6 Z" J- x4 P. V5 A k& r; V# {
一旦过滤参数设置为NULL,即表示不再进行任何的过滤。
) F% l" W% z3 C! b |