HTTP 请求实例教程 —— 获取请求数据、Cookie及文件上传处理

1、获取Request请求实例

Laravel中一般通过控制器方法依赖注入来获取当前请求的Request实例。

我们通过定义一个隐式控制器来进行本章节的测试。首先我们在routes.php定义路由如下：

Route::controller('request','RequestController');

然后我们在app/Http/Controllers下创建一个控制器RequestController.php：

<?php
 
namespace App\Http\Controllers;
 
use Illuminate\Http\Request;
use Illuminate\Http\Response;
 
use App\Http\Requests;
use App\Http\Controllers\Controller;
 
class RequestController extends Controller
{
    public function getBasetest(Request $request)
    {
        $input = $request->input('test');
        echo $input;
    }
}

要访问getBasetest方法，我们只需在浏览器中访问http://laravel.app:8000/request/basetest?test=laravelacademy，这样页面会输出：

laravelacademy

2、获取请求URL及请求方法

2.1 获取请求URL路径

要获取当前请求的URL，我们可以通过Request实例上的path方法，需要注意的是该方法返回相对请求路径，如果要获取绝对请求路径，可以通过Request实例上的另一个方法——url：

public function getUrl(Request $request)
{
    //匹配request/*的URL才能继续访问
    if(!$request->is('request/*')){
        abort(404);
    }
    $uri = $request->path();
    $url = $request->url();
    echo $uri;
    echo '<br>';
    echo $url;
}

我们在浏览器中访问http://laravel.app:8000/request/url，页面输入如下内容：

request/url
http://laravel.app:8000/request/url

2.2 获取请求方法

我们还可以通过调用Request实例上的getMethod方法获取当前请求的方法：

public function getMethod(Request $request){
    //非get请求不能访问
    if(!$request->isMethod('get')){
        abort(404);
    }
    $method = $request->method();
    echo $method;
}

3、获取请求数据

3.1 当前请求输入

使用Request实例上的input方法即可获取请求输入数据。该方法可以接收两个参数，第一个参数是传递参数名称，第二个参数是如果参数名为空返回的默认值，此外该方法还支持获取数组参数对应值，我们定义测试方法如下：

public function getInputData(Request $request){
    //获取GET方式传递的name参数，默认为LaravelAcademy
    $name = $request->input('name','LaravelAcademy');
    echo $name;
    echo '<br>';
    echo $request->input('test.0.name');
}

在浏览器中输入http://laravel.app:8000/request/input-data?name=Laravel&test[][name]=Academy，则页面输出：

Laravel
Academy

如果我们想要在获取输入值之前判断输入参数名是否存在，可以使用has方法，比如我们想要判断输入参数是否包含hello，可使用如下方法：

if($request->has('hello'))
    echo $request->input('hello');

想要获取所有输入参数值，可以使用Request实例上的all方法；想要获取部分输入值，可使用only方法；想要排除部分输入参数值，可使用except方法：

public function getInputData(Request $request){
 
    $allData = $request->all();
    $onlyData = $request->only('name','hello');
    $exceptData = $request->except('hello');
 
    echo '<pre>';
    print_r($allData);
    print_r($onlyData);
    print_r($exceptData);
}

在浏览器中访问http://laravel.app:8000/request/input-data?name=Laravel&test[][name]=Academy&hello=World，页面输出如下：

Array
(
    [name] => Laravel
    [test] => Array
    (
        [0] => Array
        (
            [name] => Academy
        )
    )
    [hello] => World
)
Array
(
    [name] => Laravel
    [hello] => World
)
Array
(
    [name] => Laravel
    [test] => Array
    (
        [0] => Array
        (
            [name] => Academy
        )
    )
)

3.2 上一次请求输入

上面的方法都是用于获取当前请求的输入，如果想要获取上一次请求的输入，需要在处理上一次请求时使用Request实例上的flash方法将请求数据暂时保存到session中，然后在当前请求中使用Request实例上的old方法获取session中保存的数据，获取到数据后就会将session中保存的请求数据销毁：

public function getLastRequest(Request $request){
    $request->flash();
}
 
public function getCurrentRequest(Request $request){
    $lastRequestData = $request->old();
    echo '<pre>';
    print_r($lastRequestData);
}

如果我们想要在上次请求保存数据后重定向到当前请求URL，则可以使用如下方式定义getLastRequest方法：

public function getLastRequest(Request $request){
    //$request->flash();
    return redirect('/request/current-request')->withInput();
}

这样我们在浏览器中访问http://laravel.app:8000/request/last-request?name=test&passwd=123456， 页面会重定向到http://laravel.app:8000/request/current-request并输出如下内容：

Array
(
    [name] => test
    [passwd] => 123456
)

再次刷新页面，输出为空：

Array
(
)

则表明取出数据后session中的请求数据被清空。更多方法使用参考HTTP请求官方文档。

4、获取Cookie数据

我们可以使用Request实例上的cookie方法获取cookie数据，该方法可以接收一个参数名返回对应的cookie值，如果不传入参数，默认返回所有cookie值：

public function getCookie(Request $request){
    $cookies = $request->cookie();
    dd($cookies);
}

我们在浏览器中访问http://laravel.app:8000/request/cookie，页面输出：

array:2 [
    "XSRF-TOKEN" => "fSP1erkCxnxX0wCyrJWJuR3ruH8c09VZXnR64nbC"
    "laravel_session" => "820e88a52c45f8dbda55e8c6aaaa9bbca2c760ef"
]

我们可以调用Response实例上的withCookie方法新增cookie：

public function getAddCookie(){
    $response = new Response();
    //第一个参数是cookie名，第二个参数是cookie值，第三个参数是有效期（分钟）
    $response->withCookie(cookie('website','LaravelAcademy.org',1));
    //如果想要cookie长期有效使用如下方法
    //$response->withCookie(cookie()->forever('name', 'value'));
    return $response;
}

我们重新定义getCookie方法如下：

public function getCookie(Request $request){
 
    $cookie = $request->cookie('website');
    echo $cookie;
}

接下来我们在浏览器中访问http://laravel.app:8000/request/add-cookie，再访问http://laravel.app:8000/request/cookie，页面输出如下：

LaravelAcademy.org

5、上传文件

我们定义文件上传页面及上传处理如下：

//文件上传表单
public function getFileupload()
{
    $postUrl = '/request/fileupload';
    $csrf_field = csrf_field();
    $html = <<<CREATE
<form action="$postUrl" method="POST" enctype="multipart/form-data">
$csrf_field
<input type="file" name="file"><br/><br/>
<input type="submit" value="提交"/>
</form>
CREATE;
    return $html;
}
 
//文件上传处理
public function postFileupload(Request $request){
    //判断请求中是否包含name=file的上传文件
    if(!$request->hasFile('file')){
        exit('上传文件为空！');
    }
    $file = $request->file('file');
    //判断文件上传过程中是否出错
    if(!$file->isValid()){
        exit('文件上传出错！');
    }
    $destPath = realpath(public_path('images'));
    if(!file_exists($destPath))
        mkdir($destPath,0755,true);
    $filename = $file->getClientOriginalName();
    if(!$file->move($destPath,$filename)){
        exit('保存文件失败！');
    }
    exit('文件上传成功！');
}

通过以上代码可以看到我们可以使用Request实例上的file方法获取上传文件实例，该方法接收的参数是上传文件input标签的name属性，该文件上传实例是 Symfony\Component\HttpFoundation\File\UploadedFile类的实例，更多有关该实例的可用方法，可参考UploadedFile的API文档。