跳到主要内容
版本：4.2

请求与输入

基本输入数据​

您可以经由几个简洁的方法拿到用户的输入数据。不需要担心发出请求时使用的 HTTP 响应方式，取得输入数据的方式都是相同的。

取得特定输入数据​

$name = Input::get('name');

取得特定输入数据，若没有便则取默认值​

$name = Input::get('name', 'Sally');

确认是否有输入数据​

if (Input::has('name'))
{
	//
}

取得所有发出请求时传入的输入数据​

$input = Input::all();

取得部分发出请求时传入的输入数据​

$input = Input::only('username', 'password');

$input = Input::except('credit_card');

如果是「数组」形式的输入数据，可以使用「点」语法取得数组：

$input = Input::get('products.0.name');
提示

有些 JavaScript 函数库如 Backbone 可能会送出 JSON 格式的输入数据，但是一样可以使用 Input::get 取得数据。

Cookies​

Laravel 建立的 cookie 会加密并且加上认证记号，意味着如果cookie被客户端擅自改动，会导致 cookie 失效。

$value = Cookie::get('name');
$response = Response::make('Hello World');

$response->withCookie(Cookie::make('name', 'value', $minutes));

如果您想在回应被建立前设定 cookie ，使用 Cookie::queue() 方法。 Cookie 会在最后自动加到回应里。

Cookie::queue($name, $value, $minutes);
$cookie = Cookie::forever('name', 'value');

旧输入数据​

您可能想要在用户下一次发送请求前，保留这次的输入数据。例如，您可能需要在表单验证失败后重新填入之前输入的表单值。

将输入数据存成一次性 Session​

Input::flash();

将部分输入数据存成一次性 Session​

Input::flashOnly('username', 'email');

Input::flashExcept('password');

您很可能常常需要在重新跳转至前一页，并将输入数据存成一次性 Session 。只要在重定向跳转方法串接的方法中传入输入数据，就能简单地完成。

return Redirect::to('form')->withInput();

return Redirect::to('form')->withInput(Input::except('password'));
提示

您可以使用 Session 类将不同请求数据存成其他一次性 Session。

取得旧输入数据​

Input::old('username');

上传文件​

取得上传文件​

$file = Input::file('photo');

确认文件是否有上传​

if (Input::hasFile('photo'))
{
	//
}

file 方法回传的对象是 Symfony\Component\HttpFoundation\File\UploadedFile 的实例， UploadedFile 继承了 PHP 的 SplFileInfo 类并且提供了很多方法和文件互动。

确认上传的文件是否有效​

if (Input::file('photo')->isValid())
{
	//
}

移动上传文件​

Input::file('photo')->move($destinationPath);

Input::file('photo')->move($destinationPath, $fileName);

取得上传文件所在的路径​

$path = Input::file('photo')->getRealPath();

取得上传文件的原始名称​

$name = Input::file('photo')->getClientOriginalName();

取得上传文件的后缀名​

$extension = Input::file('photo')->getClientOriginalExtension();

取得上传文件的大小​

$size = Input::file('photo')->getSize();

取得上传文件的 MIME 类型​

$mime = Input::file('photo')->getMimeType();

请求信息​

Request 类提供很多方法检查 HTTP 请求，它继承了 Symfony\Component\HttpFoundation\Request 类，下面是一些使用方式。

取得请求 URI​

$uri = Request::path();

取得请求方法​

$method = Request::method();

if (Request::isMethod('post'))
{
	//
}

确认请求路径是否符合特定格式​

if (Request::is('admin/*'))
{
	//
}

取得请求 URL​

$url = Request::url();

取得请求 URI 部分片段​

$segment = Request::segment(1);

取得请求 header​

$value = Request::header('Content-Type');

从 $_SERVER 取得值​

$value = Request::server('PATH_INFO');

确认是否为 HTTPS 请求​

if (Request::secure())
{
	//
}

确认是否为 AJAX 请求​

if (Request::ajax())
{
	//
}

确认请求是否有 JSON Content Type​

if (Request::isJson())
{
	//
}

确认是否要求 JSON 回应​

if (Request::wantsJson())
{
	//
}

确认要求的回应格式​

Request::format 方法会基于 HTTP Accept 标头回传请求的回应格式：

if (Request::format() == 'json')
{
	//
}