php 输入,输入 · ThinkPHP 5 简明开发手册 · 看云

## 概述

系统提供了`\think\Input`类来完成输入变量的获取和安全过滤。

## 变量获取

### 获取GET变量

~~~

\think\Input::get('id'); // 获取某个get变量

\think\Input::get('name'); // 获取get变量

\think\Input::get(); // 获取所有的get变量(数组)

~~~

或者使用内置的快捷I方法实现相同的功能：

~~~

I('get.id');

I('get.name');

I('get.');

~~~

### 获取POST变量

~~~

\think\Input::post('name'); // 获取某个post变量

\think\Input::post(); // 获取全部的post变量

~~~

使用快捷方法实现：

~~~

I('post.name');

I('post.');

~~~

### 获取PUT变量

~~~

\think\Input::put('name'); // 获取某个put变量

\think\Input::put(); // 获取全部的put变量

~~~

使用快捷方法实现：

~~~

I('put.name');

I('put.');

~~~

### 获取PARAM变量

PARAM变量是框架提供的用于自动识别GET、POST或者PUT请求的一种变量获取方式，例如：

~~~

\think\Input::param('name');

如果当前是get请求，那么等效于

\think\Input::get('name');

如果当前是post请求，则等同于

\think\Input::post('name');

~~~

使用快捷方法实现：

~~~

I('param.name');

I('param.');

或者

I('name');

I('');

~~~

因为I函数默认就采用PARAM变量读取方式。

### 获取REQUEST变量

~~~

\think\Input::request('id'); // 获取某个request变量

\think\Input::request(); // 获取全部的request变量

~~~

使用快捷方法实现：

~~~

I('request.id');

I('request.');

~~~

### 获取SERVER变量

~~~

\think\Input::server('PHP_SELF'); // 获取某个server变量

\think\Input::server(); // 获取全部的server变量

~~~

使用快捷方法实现：

~~~

I('server.PHP_SELF');

I('server.');

~~~

### 获取SESSION变量

~~~

\think\Input::session('user_id'); // 获取某个session变量

\think\Input::session(); // 获取全部的session变量

~~~

使用快捷方法实现：

~~~

I('session.user_id');

I('session.');

~~~

### 获取Cookie变量

~~~

\think\Input::cookie('user_id'); // 获取某个cookie变量

\think\Input::cookie(); // 获取全部的cookie变量

~~~

使用快捷方法实现：

~~~

I('cookie.user_id');

I('cookie.');

~~~

## 变量过滤

支持对获取的变量进行过滤，过滤方式包括函数、方法过滤，以及PHP内置的Types of filters，例如：

~~~

\think\Input::get('name','htmlspecialchars'); // 获取get变量 并用htmlspecialchars函数过滤

\think\Input::param('username','strip_tags'); // 获取param变量 并用strip_tags函数过滤

\think\Input::post('name','org\Filter::safeHtml'); // 获取post变量 并用org\Filter类的safeHtml方法过滤

~~~

可以支持传入多个过滤规则，例如：

~~~

\think\Input::param('username','strip_tags,strtolower'); // 获取param变量 并依次调用strip_tags、strtolower函数过滤

~~~

Input类还支持PHP内置提供的Filter ID过滤，例如：

~~~

\think\Input::post('email',FILTER_VALIDATE_EMAIL);

~~~

框架对FilterID做了转换支持，因此也可以使用字符串的方式，例如：

~~~

\think\Input::post('email','email');

~~~

采用字符串方式定义FilterID的时候，系统会自动进行一次filter_id调用转换成Filter常量。

具体的字符串根据filter_list函数的返回值来定义。

> 需要注意的是，采用Filter ID 进行过滤的话，如果不符合过滤要求的话 会返回false，因此你需要配合默认值来确保最终的值符合你的规范。

例如，

~~~

\think\Input::post('email',FILTER_VALIDATE_EMAIL,'');

~~~

就表示，如果不是规范的email地址的话 返回空字符串。

## 变量修饰符

I函数支持对变量使用修饰符功能，可以更好的过滤变量。

用法如下：

**I('变量类型.变量名/修饰符');**

或者

**\think\Input::get('变量名/修饰符');**

例如：

~~~

I('get.id/d');

I('post.name/s');

I('post.ids/a');

\think\Input::get('id/d');

~~~

ThinkPHP5.0版本默认的变量修饰符是`/s`，如果需要传入字符串之外的变量可以使用下面的修饰符，包括：

| 修饰符 | 作用 |

| --- | --- |

| s | 强制转换为字符串类型 |

| d | 强制转换为整形类型 |

| b | 强制转换为布尔类型 |

| a | 强制转换为数组类型 |

| f | 强制转换为浮点类型 |

>[danger] 如果你要获取的数据为数组，请一定注意要加上 `/a` 修饰符才能正确获取到。