IncomingRequest 类¶

IncomingRequest 类提供了一个客户端（比如浏览器）HTTP 请求的面向对象封装。基于它可以访问所有 Request 和 Message 中的方法，以及以下列出的方法。

获得请求
判断请求类型
数据读取
- 数据过滤
获取数据头
请求地址
上传文件
内容协商
- 类信息参考

获得请求 ¶

如果当前控制器继承了 CodeIgniter\Controller，则一个 Request 类的实例已被初始化并可作为属性被使用:

class UserController extends CodeIgniter\Controller
{
        public function index()
        {
                if ($this->request->isAJAX())
                {
                        . . .
                }
        }
}

如果在控制器外使用 Request 对象，可以通过 Services class 获得实例:

$request = \Config\Services::request();

推荐将 Request 对象作为一个依赖注入到当前类中并保存为一个属性:

use CodeIgniter\HTTP\RequestInterface;

class SomeClass
{
        protected $request;

        public function __construct(RequestInterface $request)
        {
                $this->request = $request;
        }
}

$someClass = new SomeClass(\Config\Services::request());

判断请求类型 ¶

请求有多种来源，包含使用 AJAX 发起和使用 CLI 发起的。可通过 isAJAX() and isCLI() 来检测:

// Check for AJAX request.
if ($request->isAJAX())
{
        . . .
}

// Check for CLI Request
if ($request->isCLI())
{
        . . .
}

你可以检测请求的 HTTP 类型:

// Returns 'post'
$method = $request->getMethod();

该方法默认返回类型是小写的字符串（比如 ‘get’, ‘post’ 等等），你可以通过传递 true 参数来获得大写的返回结果:

// Returns 'GET'
$method = $request->getMethod(true);

还可以通过 isSecure() 方法检测请求是否是 HTTPS:

if (! $request->isSecure())
{
        force_https();
}

你可以通过 Request 对象读取 $_SERVER, $_GET, $_POST, $_ENV, $_SESSION 内的信息。因为输入数据不会自动过滤，只会返回请求时的原始数据。而使用这些方法去替代直接获取数据的（比如 $_POST[‘something’]）主要优点是当参数不存在时会返回 null ，而且你还能做数据过滤。这可以使你很方便的直接使用数据而不需要先去判断某个参数是否存在。换句话说，一般情况下你以前会这么做:

$something = isset($_POST['foo']) ? $_POST['foo'] : NULL;

而使用 CodeIgniter 的内建方法你可以很简单的做到同样的事:

$something = $request->getVar('foo');

因为 getVar() 方法从 $_REQUEST 获得数据，所以使用它可以获得 $_GET, $POST, $_COOKIE 内的数据。虽然这很方便，但是你有时也需要使用一些特定的方法，比如:

$request->getGet()
$request->getPost()
$request->getServer()
$request->getCookie()

另外，还有一些实用的方法可以同时获取 $_GET 或者 $_POST 的数据，因为有获取顺序的问题，我们提供了以下方法:

$request->getPostGet() - 先 $_POST, 后 $_GET
$request->getGetPost() - 先 $_GET, 后 $_POST

获取 JSON 数据

你可以使用 getJSON() 去获取 php://input 传递的 JSON 格式的数据。

注解

因为无法检测来源数据是否具有有效的JSON格式，所以只有当你确认数据来源格式是JSON后才可使用。

$json = $request->getJSON();

默认情况下，这会返回一个 JSON 数据对象。如果你需要一个数据，请传递 true 作为第一个参数。

该方法的第二和第三个参数则分别对应 json_decode 方法的 depth 和 options 参数.

获取原始数据（获取 Method 为 PUT, PATCH, DELETE 传递的数据）

最后，你可以通过 getRawInput() 去获取 php://input 传递的原始数据。

$data = $request->getRawInput();

这会返回数据并转换为数组。比如:

var_dump($request->getRawInput());

[
        'Param1' => 'Value1',
        'Param2' => 'Value2'
]

数据过滤 ¶

为了保证应用程序的安全，必须过滤所有输入的数据。你可以传递过滤类型到方法的最后一个参数里。会调用系统方法 filter_var() 去过滤。具体过滤类型可以参考 PHP 手册里的列表 valid filter types.

过滤一个 POST 变量可以这么做:

$email = $request->getVar('email', FILTER_SANITIZE_EMAIL);

以上提到的方法中除了 getJSON() 和 getRawInput() ，都支持给最后一个参数传递类型来实现过滤。

获取数据头 ¶

你可以通过 getHeaders() 方法获得请求的数据头，该方法会以数组形式返回所有的数据头信息，数据的键值为数据头名称，值则为一个 CodeIgniter\HTTP\Header 的实例:

var_dump($request->getHeaders());

[
        'Host' => CodeIgniter\HTTP\Header,
        'Cache-Control' => CodeIgniter\HTTP\Header,
        'Accept' => CodeIgniter\HTTP\Header,
]

如果你只是想获得某个头的信息，你可以将数据头名称作为参数传递给 getHeader() 方法。数据头名称无视大小写，如果存在则返回指定头信息。如果不存在则返回 null

// 以下这些效果一样
$host = $request->getHeader('host');
$host = $request->getHeader('Host');
$host = $request->getHeader('HOST');

你可以使用 hasHeader() 去判断请求头是否存在:

if ($request->hasHeader('DNT'))
{
        // Don't track something...
}

如果你需要某个头的值并在一行字符串内输出，可以使用 getHeaderLine() 方法:

// Accept-Encoding: gzip, deflate, sdch
echo 'Accept-Encoding: '.$request->getHeaderLine('accept-encoding');

如果你需要完整头信息，输出包括全部名称和值的字符串，可以使用如下方法做转换:

echo (string)$header;

请求地址 ¶

你可以通过访问 $request->uri 属性获取代表当前访问信息的 doc:URI <uri> 对象。通过以下方法获取当前请求的完整访问地址:

$uri = (string)$request->uri;

该对象赋予了你访问全部请求信息的能力:

$uri = $request->uri;

echo $uri->getScheme();         // http
echo $uri->getAuthority();      // snoopy:password@example.com:88
echo $uri->getUserInfo();       // snoopy:password
echo $uri->getHost();           // example.com
echo $uri->getPort();           // 88
echo $uri->getPath();           // /path/to/page
echo $uri->getQuery();          // foo=bar&bar=baz
echo $uri->getSegments();       // ['path', 'to', 'page']
echo $uri->getSegment(1);       // 'path'
echo $uri->getTotalSegments();  // 3

上传文件 ¶

所有上传文件的信息可以通过 $request->getFiles() 方法获得，该方法会返回一个 FileCollection 实例。这会有助于减少处理文件上传的工作量，以及使用最佳方案去降低安全风险。

$files = $request->getFiles();

// Grab the file by name given in HTML form
if ($files->hasFile('uploadedFile')
{
        $file = $files->getFile('uploadedfile');

        // Generate a new secure name
        $name = $file->getRandomName();

        // Move the file to it's new home
        $file->move('/path/to/dir', $name);

        echo $file->getSize('mb');      // 1.23
        echo $file->getExtension();     // jpg
        echo $file->getType();          // image/jpg
}

你也可以通过HTML中提交的文件名去获取单个上传文件:

$file = $request->getFile('uploadedfile');

内容协商 ¶

你可以很轻松的通过 negotiate() 方法来完成信息内容类型的协商:

$language    = $request->negotiate('language', ['en-US', 'en-GB', 'fr', 'es-mx']);
$imageType   = $request->negotiate('media', ['image/png', 'image/jpg']);
$charset     = $request->negotiate('charset', ['UTF-8', 'UTF-16']);
$contentType = $request->negotiate('media', ['text/html', 'text/xml']);
$encoding    = $request->negotiate('encoding', ['gzip', 'compress']);

查看 Content Negotiation 获得更多细节。

类信息参考 ¶

注解

除了这里列出的，本类还继承了 Request Class 和 Message Class 的方法。

以下方法由父类提供:

CodeIgniter\HTTP\Request::getIPAddress()
CodeIgniter\HTTP\Request::validIP()
CodeIgniter\HTTP\Request::getMethod()
CodeIgniter\HTTP\Request::getServer()
CodeIgniter\HTTP\Message::body()
CodeIgniter\HTTP\Message::setBody()
CodeIgniter\HTTP\Message::populateHeaders()
CodeIgniter\HTTP\Message::headers()
CodeIgniter\HTTP\Message::header()
CodeIgniter\HTTP\Message::headerLine()
CodeIgniter\HTTP\Message::setHeader()
CodeIgniter\HTTP\Message::removeHeader()
CodeIgniter\HTTP\Message::appendHeader()
CodeIgniter\HTTP\Message::protocolVersion()
CodeIgniter\HTTP\Message::setProtocolVersion()
CodeIgniter\HTTP\Message::negotiateMedia()
CodeIgniter\HTTP\Message::negotiateCharset()
CodeIgniter\HTTP\Message::negotiateEncoding()
CodeIgniter\HTTP\Message::negotiateLanguage()
CodeIgniter\HTTP\Message::negotiateLanguage()

CodeIgniter\HTTP\IncomingRequest

isCLI()¶

返回:	由命令行发起的请求会返回 true ，其他返回 false。
返回类型:	bool

isAJAX()¶

返回:	AJAX请求返回 true ，其他返回 false。
返回类型:	bool

isSecure()¶

返回:	HTTPS请求返回 true ，其他返回 false。
返回类型:	bool

getVar([$index = null[, $filter = null[, $flags = null]]])¶

参数:	$index (string) – 需要查找的数据名。 $filter (int) – 过滤类型。参见列表查看。 $flags (int) – 过滤器名，值为过滤器的预定义变量名。参见列表查看。
返回:	不传参数会返回 REQUEST 中的所有元素，传参并且参数存在则返回对应的 REQUEST 值，不存在返回 null
返回类型:	mixed\|null

第一个参数包含需要查找的数据名

$request->getVar('some_data');

如数据不存在则返回 null 。

只需传递期望的过滤类型到第二个参数，就可以帮助你完成数据过滤

$request->getVar('some_data', FILTER_SANITIZE_STRING);

不传任何参数会得到一个包含全部 REQUEST 数据的数组。

第一个参数 null ，第二个参数设置过滤类型，可获得一个被过滤的包涵全部 REQUEST 数据的数组

$request->getVar(null, FILTER_SANITIZE_STRING); // returns all POST items with string sanitation

获取多个键值的信息，可以将需要的键值以数组形式传递给第一个参数

$request->getVar(['field1', 'field2']);

与之前一样，此时传递过滤类型给第二个参数，也可获得过滤后的数据

$request->getVar(['field1', 'field2'], FILTER_SANITIZE_STRING);

getGet([$index = null[, $filter = null[, $flags = null]]])¶

参数:	$index (string) – 需要查找的数据名。 $filter (int) – 过滤类型。参见列表查看。 $flags (int) – 过滤器名，值为过滤器的预定义变量名。参见列表查看。
返回:	不传参数会返回 GET 中的所有元素，传参并且参数存在则返回对应的 GET 值，不存在返回 null
返回类型:	mixed\|null

该方法与 getVar() 类似, 只返回 GET 的数据。

getPost([$index = null[, $filter = null[, $flags = null]]])¶

参数:	$index (string) – 需要查找的数据名。 $filter (int) – 过滤类型。参见列表查看。 $flags (int) – 过滤器名，值为过滤器的预定义变量名。参见列表查看。
返回:	不传参数会返回 POST 中的所有元素，传参并且参数存在则返回对应的 POST 值，不存在返回 null
返回类型:	mixed\|null

该方法与 getVar() 类似, 只返回 POST 的数据。

getPostGet([$index = null[, $filter = null[, $flags = null]]])¶

参数:	$index (string) – 需要查找的数据名。 $filter (int) – 过滤类型。参见列表查看。 $flags (int) – 过滤器名，值为过滤器的预定义变量名。参见列表查看。
返回:	不传参数会返回 POST／GET 中的所有元素，传参并且参数存在则返回对应的 POST／GET 值，不存在返回 null
返回类型:	mixed\|null

该方法和 getPost()，getGet() 类似，它会同时查找 POST 和 GET 两个数组来获取数据，先查找 POST ，再查找 GET:

$request->getPostGet('field1');

getGetPost([$index = null[, $filter = null[, $flags = null]]])¶

参数:	$index (string) – 需要查找的数据名。 $filter (int) – 过滤类型。参见列表查看。 $flags (int) – 过滤器名，值为过滤器的预定义变量名。参见列表查看。
返回:	不传参数会返回 POST／GET 中的所有元素，传参并且参数存在则返回对应的 POST／GET 值，不存在返回 null
返回类型:	mixed\|null

该方法和 getPost()，getGet() 类似，它会同时查找 POST 和 GET 两个数组来获取数据，先查找 GET ，再查找 POST:

$request->getGetPost('field1');

getCookie([$index = null[, $filter = null[, $flags = null]]])¶

参数:	$index (string) – COOKIE 名。 $filter (int) – 过滤类型。参见列表查看。 $flags (int) – 过滤器名，值为过滤器的预定义变量名。参见列表查看。
返回:	不传参数会返回 COOKIE 中的所有元素，传参并且参数存在则返回对应的 COOKIE 值，不存在返回 null
返回类型:	mixed

该方法与 getPost()，getGet() 类似, 只返回 COOKIE 的数据

$request->getCookie('some_cookie');
$request->getCookie('some_cookie', FILTER_SANITIZE_STRING); // with filter

获取多个键值的信息，可以将需要的键值以数组形式传递给第一个参数

$request->getCookie(array('some_cookie', 'some_cookie2'));

注解

与 Cookie Helper function get_cookie() 不同, 该方法不会自动添加配置中 $config['cookie_prefix'] 的值。

getServer([$index = null[, $filter = null[, $flags = null]]])¶

参数:	$index (string) – 服务器信息名。 $filter (int) – 过滤类型。参见列表查看。 $flags (int) – 过滤器名，值为过滤器的预定义变量名。参见列表查看。
返回:	不传参数会返回 SERVER 中的所有元素，传参并且参数存在则返回对应的 SERVER 值，不存在返回 null
返回类型:	mixed

该方法与 getPost()，getGet() ，getCookie() 类似, 只返回 SERVER 的数据

$request->getServer('some_data');

获取多个键值的信息，可以将需要的键值以数组形式传递给第一个参数

$request->getServer(['SERVER_PROTOCOL', 'REQUEST_URI']);

getUserAgent([$filter = null])¶

参数:	$filter (int) – 过滤类型。参见列表查看。
返回:	包含 User Agent 信息的字符串，不存在返回 null
返回类型:	mixed

该方法从服务器信息哪查找并以字符串形式返回 User Agent

$request->getUserAgent();