laravel基础教程 -- 请求

HTTP请求

访问请求

为了通过依赖注入能够方便的获取http请求实例，你应该在控制器的构造函数或者控制函数中写入类型声明Illuminate\Http\Request。当前请求的实例会自动的从服务容器中注入:

input('name');  }}

如果你的控制器方法也需要接收来自路由的参数，那么你需要在进行依赖注入的参数之后添加要接收的参数。例如，你的路由是这么定义的：

Route::put('user/{id}', 'UserController@update');

那么你应该先声明依赖注入Illuminate\Http\Reqeust,然后再按序的传递路由参数:

基础的请求信息
   
Illuminate\Http\Request的实例为你的应用提供了多种检查HTTP请求的方法，它继承自Symfony\Component\HttpFoundation\Request。这里列举了一些常用的方法:
   
检索请求的URI
   
path方法返回请求的URI.所以，当请求的目标地址是http://domain.com/foo/bar时，path方法将返回foo/bar:
   
$uri = $request->path();
   
is方法允许你来效验所请求的URI是否匹配所提供的模式。你可以使用 *字符来作为通配符:
   
if ($request->is('admin/*')) {  //}
   
如果你想得到请求的完整路径，那么你可以使用 url 或 fullUrl 方法：
   
// Without Query String...$url = $request->url();// With Query String...$url = $request->fullUrl();
   
你也可以在获取完整请求路径的同时追加请求的参数信息，例如，如果请求的目标是 http://domain.com/foo, 下面的方法将返回http://domain.com/foo?bar=baz:
   
$url = $request->fullUrlWithQuery(['bar' => 'baz']);
   
检索请求的方式
   
method方法将返回HTTP请求的方式。你也可以使用isMethod方法来进行http请求方式的匹配效验:
   
$method = $request->method();if ($request->isMethod('post')) {  //}
   
PSR-7 请求
   
PSR-7标准为http指定了一些消息接口，包括请求和响应.如果你想获得PSR-7请求的实例，你需要先安装一些支持库，laravel使用了 Symfon HTTP Bridge 组件来转换典型的laravel请求和响应为PSR-7兼容的实现:
   
composer require symfony/psr-http-message-bridgecomposer require zendframework/zend-diactoros
   
一旦你安装了这些库，你就可以简单在你的路由或控制器中使用类型提示来获取PSR-7请求:
   
use Psr\Http\Message\ServerRequestInterface;Route::get('/', function (ServerRequestInterface $request) {  // });
   
如果路由或控制器返回的是PSR-7响应的实例， 那么它会自动的转换为laravel响应实例。
   
获取输入值
   
获取输入的值
   
你可以通过Illuminate\Http\Request实例的一些方法来简便的获取用户的输入值.而且你并不需要去关心用户所使用的HTTP请求方式，你可以通过input方法获取所有请求方式的值:
   
$name = $request->input('name');
   
你也可以传递第二个参数到input方法，如果该值并不存在于请求中，将作为默认值返回:
   
$name = $request->input('name', 'Sally');
   
当表单提交的一些输入值是数组时,你可以使用.操作符来访问请求中的数组值:
   
$name = $request->input('products.0.name');$names = $request->input('products.*.name');
   
获取JSON请求的输入值
   
你同样可以使用input方法来访问json请求，只要json请求被设置了正确的请求头 Content-Type: application/json， 那么你就可以使用 . 语法来深入访问json中的数组:
   
$name = $request->input('user.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');
   
动态属性
   
你可以通过Illuminat\Http\Request的实例的动态属性来获取用户的输入值.如果你的应用表单中存在name字段，你可以通过下面的方式来获取该请求字段:
   
$name = $request->name;
   
当使用动态属性时，laravel会首先查找请求中是否包含该值，然后才会检索路由中的参数.
   
旧的输入
   
laravel允许你在下一次请求期间保持该次请求的输入。这种特性在表单验证出错时尤其有用，它可以使你复用上一次的请求进行自动的填充。如果你使用了laravel的验证服务，那么你不需要手动的调用它们，因为laravel内置的验证机制会自动的调用它们。
   
闪存输入到会话
   
Illuminate\Http\Request实例的flash方法会闪存当前请求的输入到会话中，这样可以使应用在接受用户的下次请求时进行复用:
   
$request->flash();
   
你也可以使用flashOnly和 flashExcept 方法来闪存部分请求输入到会话：
   
$request->flashOnly(['username', 'email']);$request->flashExcept('password');
   
闪存输入到会话接着跳转
   
一个常用的场景就是你需要连同用户的输入一起返回到上一页中，那么你可以使用withInput链式方法:
   
return redirect('form')->withInput();return redirect('form')->withInput($request->except('password'));
   
获取旧输入
   
你可以使用old方法来获取上一次请求所闪存的用户请求：
   
$username = $request->old('username');
   
laravel提供了全局old帮助方法。你也可以在blade模板中使用该方法，如果上次请求未闪存该输入，则会返回null:
   
   
Cookies
   
从请求中检索cookie
   
在laravel中所有的cookie在被创建时都会经过一个认证码进行签证加密，这就意味着laravel会验证客户端对cookie的修改.你可以使用Illuminate\Http\Request实例的cookie方法来获取cookie值:
   
$value = $request->cookie('name');
   
在响应中附加一个新的cookie
   
laravel提供了一个全局的cookie帮助方法用来生成一个Symfony\Component\HttpFoundation\Cookie实例，该实例可以被Illuminate\Http\Response实例的withCookie附加:
   
$response = new Illuminate\Http\Response('Hello World');$response->withCookie('name', 'value', $minutes);return $response;
   
你可以使用cookie方法来创建一个长达5年的长cookie，它要求你使用不带参数的cookie帮助方法直接调用forever方法:
   
$response->withCookie(cookie()->forever('name', 'value'));
   
文件
   
获取上传的文件
   
你可以通过Illuminate\Http\Request的file方法来访问上传的文件。该方法会返回一个Symfony\Component\HttpFoundation\File\UploadedFile类的实例，它继承自SplFileInfo，提供了多种与文件交互的方法：
   
$file = $request->file('photo');
   
你可以使用hasFile方法来判断文件在请求中是否存在:
   
if ($request->hasFile('photo')) {  // }
   
验证文件是否上传成功
   
你可以使用isValid方法来验证文件上传的过程中是否出错:
   
if ($request->file('photo')->isValid()) {  //}
   
移动上传的文件
   
你可以使用move方法来将上传的文件从临时目录中迁移到指定的目录中:
   
$request->file('photo')->move($destinationPath);$request->file('photo')->move($destinationPath, $fileName);
   
其他文件方法
   
UploadedFile还有其他许多可用的方法，你可以查看 该类的API文档 来了解更多.