laravel 学习指南 第五章 第四节

发表于 更新于 分类于 Disqus：
  • TOC
    {:toc}

5.4 请求

5.4.1 获取请求

通过依赖注入获取当前HTTP请求实例，应该在控制器的构造函数或方法中对Illuminate\Http\Request类进行类型提示，当前请求实例会被服务容器自动注入：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
<?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进行类型提示并通过如下方式定义控制器方法来访问路由参数：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
<?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)
    {
        //
    }
}

5.4.1.1 基本请求信息

Illuminate\Http\Request实例提交了多个方法来检查应用的HTTP请求，laravel的Illuminate\Http\Request继承自Symfony\Component\HttpFoundation\Request类，下面演示了一些有用的方法：

  • 获取请求URI

    path方法将会返回请求的URI（返回的是域名之后的部分），如果进入的请求路径是http://domain.com/foo/bar,则path方法将会返回foo/bar:

      $uri=$request->path();

    is方法允许你验证进入的请求是否与给定模式匹配。使用该方法可以使用*通用符：

    1
    2
    3
    if($request->is('admin/*')){
    //
    }

    想要获取完整的URL，而不仅仅是路径信息，可以使用请求实例中的url或fullUrl方法：

    1
    2
    $url=$request->url();
    $url = $request->fullUrl();

  • 获取请求方法

    method方法将会返回请求的HTTP请求方式。你可以使用isMethod方法来验证HTTP请求方式是否匹配给定字符串：

    1
    2
    3
    4
    $method=$request->method();
    if($request->isMethod('post')){ 
        //
    }

5.4.1.2 PSR-7 请求

PSR-7标准指定了HTTP信息接口，包括请求和响应。如果想要获取PSR-7请求实例，首先需要安装一些库，laravel使用Symfony HTTP Message Bridge组件，将原的laravel请求和响应转化为PSR-7兼容的请求：

1
2
composer require symfony/psr-http-message-bridge
composer require zendframework/zend-diactoros

安装完这些库之后，只需要在路由或控制器中通过，对请求类型进行类型提示就可以获取RSR-7请求：

1
2
3
4
5
use Psr\Http\Message\ServerRequestInterface;

Route::get('/', function (ServerRequestInterface $request) {
//
});

如果从路由或控制器返回的是PSR-7响应实例，则其将会自动转化为laravel响应实例并显示出来。

5.4.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:

    1
    2
    3
    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');

5.4.2.1 上一次请求输入

laravel 允许你在两次请求之间保存输入数据，这个特性在检测校验数据失败后需要重新填充表单数据时很有用。

但如果使用的是laravel内置的验证服务，则不需要手动使用这些方法，因为一些laravel内置的校验会自动调用它们。

  • 将输入存储到一次性Session

    Illuminate\Http\Request实例的flash方法会将当前输入存放到一次性Session中，下次使用者发出请求至应用程序时就可以使用它们：

      $request->flash();

    还可以使用flashOnly和flashExcept方法将输入数据子集存储到Session中：

      $request->flashOnly('username', 'email');
  $request->flashExcept('password');

  • 将输入存储到一次性Session然后重定向

    可能常常需要使用Session中的数据，并重新定向到前一页。可以简单使用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') }}

5.4.2.2 Cookies

  • 从请求中取出Cookies

    laravel 框架创建的所有cookies都经过加密并使用一个认证码进行签名，这意味着如果客户端修改了它们则需要对其进行有效性验证。使用Illuminate\Http\Request类中的 cookie方法从请求中获取cookie的值：

      $value = $request->cookie('name');

  • 新增Cookies到回应

    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'));

5.4.2.3 文件上传

  • 获取上传的文件

    使用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设定来确定）移动到指定的永久保存位置：

    1
    2
    3
    $request->file('photo')->move($destinationPath);

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

  • 其它文件方法

    UploadedFile实例中有很多可用的方法。可以到该类的API了解。