[TOC]
### **1、访问[请求](http://laravelacademy.org/tags/%e8%af%b7%e6%b1%82 "View all posts in 请求")实例**
通过依赖注入获取当前 [HTTP](http://laravelacademy.org/tags/http "View all posts in HTTP") 请求实例，应该在控制器的构造函数或方法中对 `Illuminate\Http\[Request](http://laravelacademy.org/tags/request "View all posts in Request")` 类进行类型提示，当前请求实例会被服务容器自动注入：
~~~
<?php
namespace App\Http\Controllers;
use Illuminate\Http\Request;
use Illuminate\Routing\Controller;
class UserController extends Controller
{
/**
* 存储新用户
*
* @param Request $request
* @return Response
*/
public function store(Request $request)
{
$name=$request->input('name');
//
}
}
~~~
如果你的控制器方法还期望获取路由参数输入，只需要将路由参数置于其它依赖之后即可，例如，如果你的路由定义如下：
~~~
Route::put('user/{id}','UserController@update');
~~~
你仍然可以对 `Illuminate\Http\Request` 进行类型提示并通过如下方式定义控制器方法来访问路由参数：
~~~
<?php
namespace App\Http\Controllers;
use Illuminate\Http\Request;
use Illuminate\Routing\Controller;
classUser Controller extends Controller
{
/**
* 更新指定用户
*
* @param Request $request
* @param int $id
* @return Response
*/
public function update(Request $request,$id)
{
//
}
}
~~~
#### **基本请求信息**
`Illuminate\Http\Request` 实例提供了多个方法来检测应用的 HTTP 请求，[Laravel](http://laravelacademy.org/tags/laravel "View all posts in Laravel") 的 `Illuminate\Http\Request`继承自 `Symfony\Component\HttpFoundation\Request` 类，下面演示了一些该类中的有用方法：
**获取请求URI**
`path` 方法将会返回请求的 URI，因此，如果进入的请求路径是 `http://domain.com/foo/bar`，则 `path` 方法将会返回 `foo/bar`：
~~~
$uri=$request->path();
~~~
`is` 方法允许你验证进入的请求是否与给定模式匹配。使用该方法时可以使用 `*` 通配符：
~~~
if($request->is('admin/*')){
//
}
~~~
想要获取完整的 URL，而不仅仅是路径信息，可以使用请求实例中的 `url` 或 `fullUrl` 方法：
~~~
$url=$request->url();
$url = $request->fullUrl();
~~~
**获取请求方法**
`method` 方法将会返回请求的 HTTP 请求方式。你还可以使用 `isMethod` 方法来验证 HTTP 请求方式是否匹配给定字符串：
~~~
$method=$request->method();
if($request->isMethod('post')){
//
}
~~~
#### **[PSR-7](http://laravelacademy.org/tags/psr-7 "View all posts in PSR-7") 请求**
[PSR-7 标准](http://www.php-fig.org/psr/psr-7/)指定了 HTTP 消息接口，包括请求和响应。如果你想要获取 PSR-7 请求实例，首先需要安装一些库，Laravel 使用 Symfony HTTP Message Bridge 组件将典型的 Laravel 请求和响应转化为 PSR-7 兼容的实现：
~~~
composer require symfony/psr-http-message-bridge
composer require zendframework/zend-diactoros
~~~
安装完这些库之后，你只需要在路由或控制器中通过对请求类型进行类型提示就可以获取 PSR-7 请求：
~~~
use Psr\Http\Message\ServerRequestInterface;
Route::get('/', function (ServerRequestInterface $request) {
//
});
~~~
如果从路由或控制器返回的是 PSR-7 响应实例，则其将会自动转化为 Laravel 响应实例并显示出来。
### **2、获取请求输入**
**获取输入值**
使用一些简单的方法，就可以从 `Illuminate\Http\Request` 实例中访问用户输入。你不需要关心请求所使用的 HTTP 请求方法，因为对所有请求方式的输入访问接口都是一致的：
~~~
$name = $request->input('name');
~~~
此外，你也可以通过使用 `Illuminate\Http\Request` 实例上的动态属性来访问用户输入。例如，如果你的应用表单包含 `name` 字段，那么可以像这样访问提交的值：
~~~
$name = $request->name;
~~~
你还可以传递一个默认值作为第二个参数给 `input` 方法，如果请求输入值在当前请求未出现时该值将会被返回：
~~~
$name = $request->input('name', 'Sally');
~~~
处理表单数组输入时，可以使用”.”来访问数组输入：
~~~
$input = $request->input('products.0.name');
$names = $request->input('products.*.name');
~~~
**判断输入值是否出现**
判断值是否在请求中出现，可以使用 `has` 方法，如果值出现过了且不为空，`has` 方法返回 `true`：
~~~
if ($request->has('name')) {
//
}
~~~
**获取所有输入数据**
你还可以通过 `all` 方法获取所有输入数据：
~~~
$input = $request->all();
~~~
**获取输入的部分数据**
如果你需要取出输入数据的子集，可以使用 `only` 或 `except` 方法，这两个方法都接收一个数组或动态列表作为唯一参数：
~~~
$input = $request->only(['username', 'password']);
$input = $request->only('username', 'password');
$input = $request->except(['credit_card']);
$input = $request->except('credit_card');
~~~
#### **上一次请求输入**
Laravel 允许你在两次请求之间保存输入数据，这个特性在检测校验数据失败后需要重新填充表单数据时很有用，但如果你使用的是 Laravel 内置的验证服务，则不需要手动使用这些方法，因为一些 Laravel 内置的校验设置会自动调用它们。
**将输入存储到一次性 [Session](http://laravelacademy.org/tags/session "View all posts in Session")**
`Illuminate\Http\Request` 实例的 `flash` 方法会将当前输入存放到一次性 Session（所谓的一次性指的是从 Session 中取出数据中，对应数据会从 Session 中销毁）中，这样在下一次请求时数据依然有效：
~~~
$request->flash();
~~~
你还可以使用 `flashOnly` 和 `flashExcept` 方法将输入数据子集存放到 Session 中：
~~~
$request->flashOnly('username', 'email');
$request->flashExcept('password');
~~~
**将输入存储到一次性 Session 然后[重定向](http://laravelacademy.org/tags/%e9%87%8d%e5%ae%9a%e5%90%91 "View all posts in 重定向")**
如果你经常需要一次性存储输入并重定向到前一页，可以简单使用 `withInput` 方法来将输入数据链接到 `redirect`后面：
~~~
return redirect('form')->withInput();
return redirect('form')->withInput($request->except('password'));
~~~
**取出上次请求数据**
要从 Session 中取出上次请求的输入数据，可以使用 Request 实例的 `old` 方法。`old` 方法提供了便利的方式从 Session 中取出一次性数据：
~~~
$username = $request->old('username');
~~~
Laravel 还提供了一个全局的辅助函数 `old`，如果你是在 Blade 模板中显示上次输入数据，使用辅助函数 `old` 更方便，如果给定参数没有对应输入，返回 null：
~~~
{{ old('username') }}
~~~
#### **[Cookie](http://laravelacademy.org/tags/cookie "View all posts in Cookie")s**
**从请求中取出Cookies**
Laravel 框架创建的所有 cookies 都经过加密并使用一个认证码进行签名，这意味着如果客户端修改了它们则需要对其进行有效性验证。我们使用 `Illuminate\Http\Request` 实例的 `cookie `方法从请求中获取 cookie 的值：
~~~
$value = $request->cookie('name');
~~~
**新增Cookie到响应**
Laravel 提供了一个全局的辅助函数 `cookie` 作为一个简单工厂来生成新的`Symfony\Component\HttpFoundation\Cookie` 实例，新增的 cookie 通过 `withCookie` 方法被附加到`Illuminate\Http\Response` 实例：
~~~
$response = new Illuminate\Http\Response('Hello World');
$response->withCookie(cookie('name', 'value', $minutes));
return $response;
~~~
想要创建一个长期有效的 cookie，可以使用 cookie 工厂的 `forever `方法：
~~~
$response->withCookie(cookie()->forever('name', 'value'));
~~~
#### **[文件上传](http://laravelacademy.org/tags/%e6%96%87%e4%bb%b6%e4%b8%8a%e4%bc%a0 "View all posts in 文件上传")**
**获取上传的文件**
可以使用 `Illuminate\Http\Request` 实例的 `file` 方法来访问上传文件，该方法返回的对象是`Symfony\Component\HttpFoundation\File\UploadedFile` 类的一个实例，该类继承自 PHP 标准库中提供与文件交互方法的 `SplFileInfo` 类：
~~~
$file = $request->file('photo');
~~~
验证文件是否存在使用 `hasFile` 方法判断文件在请求中是否存在：
~~~
if ($request->hasFile('photo')) {
//
}
~~~
**验证文件是否上传成功**
使用 `isValid` 方法判断文件在上传过程中是否出错：
~~~
if ($request->file('photo')->isValid()){
//
}
~~~
**保存上传的文件**
使用 `move` 方法将上传文件保存到新的路径，该方法将上传文件从临时目录（在 PHP 配置文件中配置）移动到指定新目录：
~~~
$request->file('photo')->move($destinationPath);
$request->file('photo')->move($destinationPath, $fileName);
~~~
**其它文件方法**
UploadedFile 实例中很有很多其它方法，查看[该类的 API](http://api.symfony.com/2.7/Symfony/Component/HttpFoundation/File/UploadedFile.html) 了解更多相关方法。
- 序言
- 发行版本说明
- 升级指南
- 贡献代码
- 开始
- 安装
- 配置
- Laravel Homestead
- 基础
- HTTP 路由
- HTTP 中间件
- HTTP 控制器
- HTTP 请求
- HTTP 响应
- 视图
- Blade 模板引擎
- 架构
- 一次请求的生命周期
- 应用目录结构
- 服务提供者
- 服务容器
- 门面（Facades）
- 数据库
- 起步
- 查询构建器
- 迁移
- 填充数据
- Eloquent ORM
- 起步
- 关联关系
- 集合
- 访问器&修改器
- 序列化
- 服务
- 用户认证
- 用户授权
- Artisan Console
- 订阅支付实现：Laravel Cashier
- 缓存
- 集合
- 集成前端资源：Laravel Elixir
- 加密
- 错误&日志
- 事件
- 文件系统/云存储
- 哈希
- 辅助函数
- 本地化
- 邮件
- 包开发
- 分页
- Redis
- 队列
- Session
- Envoy Task Runner
- 任务调度
- 测试
- 验证
- 新手入门指南
- 简单任务管理系统
- 带用户功能的任务管理系统