HTTP 请求参数获取、Cookie设置及文件上传 | 基础组件 | Laravel 5.5 中文文档
Laravel 学院
文档
Laravel 8.x 中文文档
Laravel 7.x 中文文档
Laravel 6.x 中文文档
Laravel 5.8 中文文档
Laravel 5.7 中文文档
Laravel 5.6 中文文档
Laravel 5.5 中文文档
Laravel 5.4 中文文档
Laravel 5.3 中文文档
Laravel 5.2 中文文档
Laravel 5.1 中文文档
Lumen 中文文档
全栈教程
PHP 全栈工程师指南
PHP 入门到实战
Laravel 入门到精通
Vue.js 入门到实战
玩转 PhpStorm 教程
Laravel 博客入门项目
Laravel 微信小程序项目
Laravel 前后端分离项目
Swoole 入门到实战
Eloquent 性能优化实战
Redis 高性能实战系列
Laravel 新版本特性
PHP 新特性与最佳实践
Golang
Go 入门教程
Go Web 编程
Gin 使用教程
微服务开发
内功修炼
数据结构与算法
网络协议
微服务从入门到实践
高性能 MySQL 实战
高性能 Redis 实战
Laravel 消息队列实战
Laravel 从学徒到工匠
PHP 设计模式系列
名企面试指南
资源库
Laravel 资源大全
Laravel 开源项目
Laravel 扩展包
Laravel 资源下载
更多
博客 & 新闻
问答 & 讨论
Leetcode 题解
学院君读书笔记系列
关于 Laravel 学院
Laravel 互助学习群
Golang 互助学习群
更多
Laravel 中文文档
Laravel 全栈教程
Laravel 学习路径
Go 入门教程
程序员内功修炼
博客
问答
搜索
注册
登录
Info
Content
章节导航
Laravel 5.5 中文文档
目录索引
序言
2篇文章
新版特性
升级指南
快速入门
6篇文章
安装配置篇
目录结构篇
重量级开发环境：Homestead 安装使用详细教程
轻量级开发环境：Valet 安装使用详细教程
使用 Laradock 搭建基于 Docker 的 PHP 开发环境
使用 Laragon 在 Windows 中搭建 Laravel 开发环境
核心架构
5篇文章
一次 Laravel 请求的生命周期
服务容器
服务提供者
门面（Facades）
契约（Contracts）
基础组件
14篇文章
Laravel 应用的入口：路由系列之基础入门篇
Laravel 应用的入口：路由系列之参数、命名和分组篇
Laravel 应用的入口：路由系列之路由模型绑定篇
HTTP 请求的过滤器：中间件
使用中间件 VerifyCsrfToken 避免 CSRF 攻击
HTTP 请求的处理层：控制器
HTTP 请求参数获取、Cookie设置及文件上传
HTTP 响应、重定向及文件下载
Laravel 视图渲染：Blade 模板引擎
Laravel 视图的创建和数据传递
辅助函数篇：请求 URL 生成
Session 实现、配置与使用详解
请求表单验证及错误处理大全
异常处理 & 错误日志
前端开发
3篇文章
视图渲染本地化：让你的应用轻松实现多语言支持
快速入门：JavaScript & CSS 脚手架
使用进阶：通过 Laravel Mix 编译前端资源
安全系列
6篇文章
在 Laravel 中实现用户注册登录认证
使用 Laravel Passport 实现 API 认证
在 Laravel 中实现对资源操作的权限控制
在 Laravel 中对敏感数据进行加密解密
使用哈希算法在 Laravel 中实现密码加密
如何在 Laravel 中实现密码重置功能
数据库操作
5篇文章
快速入门：基本配置和使用、读写分离 & 数据库事务
使用进阶：通过查询构建器实现高级功能
在 Laravel 中轻松实现分页功能
数据库迁移：以版本控制的方式维护数据表
数据库填充器：初始化测试数据的好帮手
Eloquent模型
6篇文章
入门篇：使用 Eloquent 模型进行数据库操作
进阶篇：使用 Eloquent 模型管理关联关系
Eloquent 查询返回的数据格式：集合
使用访问器和修改器格式化模型数据
API 资源类：架起模型与 JSON API 之间的桥梁
将模型数据序列化为数组或 JSON
进阶系列
13篇文章
使用 Artisan 构建强大的控制台应用
通过事件和事件监听器实现服务解耦
Laravel 队列系统实现及使用教程
Laravel 中服务端与客户端事件广播实现
通过缓存构建高性能 Laravel 应用
键值对存储系统 Redis 在 Laravel 中的使用
集合：给 PHP 数组插上翅膀
辅助函数：简化 Laravel 代码编写的利器
集成 Flysystem 实现对文件系统的高级操作
在 Laravel 中实现邮件配置、预览和发送
在 Laravel 中使用多种通道实现通知发送
Laravel 自定义扩展包的开发和使用
定时任务调度在 Laravel 中的实现
测试
5篇文章
快速入门：集成 PHPUnit 编写测试用例
HTTP 测试：如何测试 HTTP 请求和响应
浏览器测试：使用 Laravel Dusk 进行浏览器测试
数据库测试：模型工厂生成及使用
模拟：通过伪造事件、邮件、通知、队列、文件存储等服务简化测试
官方扩展包
5篇文章
订阅支付解决方案：Laravel Cashier
远程操作解决方案：Envoy Task Runner
队列系统解决方案：Laravel Horizon
全文搜索解决方案：Laravel Scout
第三方登录解决方案：Laravel Socialite
图书
Laravel 5.5 中文文档
基础组件
HTTP 请求参数获取、Cookie设置及文件上传
HTTP 请求参数获取、Cookie设置及文件上传
由 学院君 创建于5年前, 最后更新于 2年前
版本号 #2
74022 views
20 likes
0 collects
访问请求实例
在控制器中获取当前 HTTP 请求实例，需要在构造函数或方法中对 Illuminate\Http\Request 类进行依赖注入，这样当前请求实例会被服务容器自动注入：
<?php
namespace App\Http\Controllers;
use Illuminate\Http\Request;
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 进行依赖注入并通过如下方式定义控制器方法来访问路由参数 id：
<?php
namespace App\Http\Controllers;
use Illuminate\Http\Request;
class UserController extends Controller
/**
* 更新指定用户
* @param Request $request
* @param int $id
* @return Response
*/
public function update(Request $request, $id)
//
通过路由闭包访问请求
还可以在路由闭包中注入 Illuminate\Http\Request，在执行闭包函数的时候服务容器会自动注入输入请求：
use Illuminate\Http\Request;
Route::get('/', function (Request $request) {
//
});
请求路径 & 方法
Illuminate\Http\Request 继承自 Symfony\Component\HttpFoundation\Request 类，提供了多个方法来检测应用的 HTTP 请求，下面我们来演示其提供的一些获取请求路径和请求方式的方法：
获取请求路径
path 方法将会返回请求的路径信息，因此，如果请求URL是 http://domain.com/user/1，则 path 方法将会返回 user/1：
$path = $request->path();
is 方法允许你验证请求路径是否与给定模式匹配。该方法参数支持 * 通配符：
if($request->is('user/*')){
//
如果请求URL是 http://domain.com/user/1，该方法会返回 true。
获取请求URL
想要获取完整的 URL，而不仅仅是路径信息，可以使用请求实例提供的 url 或 fullUrl 方法， url 方法返回不带查询字符串的 URL，而 fullUrl 方法返回结果则包含查询字符串：
// 不包含查询字符串
$url = $request->url();
// 包含查询字符串
$url_with_query = $request->fullUrl();
例如，我们请求 http://domain.com/user/1?token=laravelacademy.org，则上述 $url 的值是 http://domain.com/user/1，$url_with_query 的值是 http://blog.dev/user/1?token=laravelacademy.org。
获取请求方法
method 方法将会返回 HTTP 请求方式。你还可以使用 isMethod 方法来验证 HTTP 请求方式是否匹配给定字符串：
$method = $request->method(); // GET/POST
if($request->isMethod('post')){
// true or false
PSR-7 请求
PSR-7 标准指定了 HTTP 消息接口，包括请求和响应。如果你想要获取遵循 PSR-7 标准的请求实例而不是 Laravel 请求实例，首先需要安装一些库。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) {
//
});
对比下 Request 实例和 ServerRequestInterface 实例的数据结构，可以看到 Laravel 的 Request 实例提供信息更丰富：
注：如果从路由或控制器返回的是 PSR-7 响应实例，则其将会自动转化为 Laravel 响应实例并显示出来。
请求字符串处理
默认情况下，Laravel 在 App\Http\Kernel 的全局中间件堆栈中引入了 TrimStrings 和 ConvertEmptyStringsToNull 中间件。这些中间件会自动对请求中的字符串字段进行处理，前者将字符串两端的空格清除，后者将空字符串转化为 null。这样，在路由和控制器中我们就不必对字符串字段做额外的处理：
如果你想要禁止该行为，可以从 App\Http\Kernel 的中间件堆栈属性 $middleware 中移除这两个中间件。
获取请求输入
获取所有输入值
你可以使用 all 方法以数组格式获取所有输入值：
$input = $request->all();
如果请求 URL 是 http://blog.dev/user/1?token=laravelacademy.org&name=学院君，则对应 $input 返回值是：
获取单个输入值
通过一些很简单的方法，就可以从 Illuminate\Http\Request 实例中访问用户输入。你不需要关心请求所使用的 HTTP 请求方式，因为对所有请求方式都是通过 input 方法获取用户输入：
$name = $request->input('name');
还是以上面的请求 URL 为例，这里的 $name 值是 学院君。
你还可以传递一个默认值作为第二个参数给 input 方法，如果请求输入值在当前请求 URL 中未出现时该值将会被返回：
$name = $request->input('name', '学院君');
比如我们访问 http://blog.dev/user/1?token=laravelacademy.org，仍然可以获取到 $name 的值为 学院君。
处理表单数组输入时，可以使用”.”来访问数组输入：
$input = $request->input('products.0.name');
$names = $request->input('products.*.name');
比如我们访问 http://blog.dev/user/1?products[][name]=学院君&products[][name]=学院君小号，则上述 $input 的值是 学院君，而 $names 的值是：
从查询字符串中获取输入
input 方法会从整个请求负载（包括查询字符串）中获取数值，query则只会从查询字符串中获取数值：
$name = $request->query('name');
如果请求的查询字符串中没有提供给定的查询项，我们可以像 input 方法一样设置第二个参数为默认值：
$name = $request->query('name', '学院君');
你也可以调用一个不传任何参数的 query 方法以便以关联数组的方式获取整个查询字符串的值，类似 all 方法所做的：
$query = $request->query();
写到这里，估计有些人要蒙圈了，那 input 和 query 到底有什么区别，官方文档还是有些含混不清，那么这里学院君一杆子打到底，跟你聊聊两者的本质区别，回到上面打印 Request 实例那张图：
注意到标红圈的部分，query 方法就是从 query 属性对象中获取参数值，input 方法会从 query + request 属性对象中获取参数值，请求实例上还有个 post 方法用于从 request 属性对象中获取参数值，讲到这里我们应该有点眉目了，query 方法用于获取 GET 请求查询字符串参数值，input 方法用于获取所有 HTTP 请求参数值，post 方法用于获取 POST 请求参数值。感兴趣的同学可以去底层查看下源码：vendor/laravel/framework/src/Illuminate/Http/Concerns/InteractsWithInput.php。
通过动态属性获取输入
此外，你还可以通过使用 Illuminate\Http\Request 实例上的动态属性来访问用户输入。例如，如果你的应用表单包含 name 字段，那么可以像这样访问提交的值：
$name = $request->name;
使用动态属性的时候，Laravel 首先会在请求中查找参数的值，如果不存在，还会到路由参数中查找。该功能的实现原理自然是魔术函数 __get 了：
要我说，这些语法糖没啥用，对性能没啥提升，只是方便使用而已，但这样也会增加使用者学习语法的成本。
获取JSON输入值
发送 JSON 请求到应用的时候，只要 Content-Type 请求头被设置为 application/json，都可以通过 input 方法获取 JSON 数据，还可以通过“.”号解析数组：
$name = $request->input('user.name');
获取输入的部分数据
如果你需要取出输入数据的子集，可以使用 only 或 except 方法，这两个方法都接收一个数组或动态列表作为唯一参数，这和我们在上一篇控制器中提到的控制器中间件使用语法类似：
$input = $request->only(['username', 'password']);
$input = $request->only('username', 'password');
$input = $request->except(['credit_card']);
$input = $request->except('credit_card');
注：only 方法返回所有你想要获取的参数键值对，不过，如果你想要获取的参数不存在，则对应参数会被过滤掉。
判断请求参数是否存在
判断参数在请求中是否存在，可以使用 has 方法，如果参数存在则返回 true：
if ($request->has('name')) {
//
该方法支持以数组形式查询多个参数，这种情况下，只有当参数都存在时，才会返回 true：
if ($request->has(['name', 'email'])) {
//
如果你想要判断参数存在且参数值不为空，可以使用 filled 方法：
if ($request->filled('name')) {
//
上一次请求输入
Laravel 允许你在两次请求之间保存上一次输入数据，这个特性在检测校验数据失败后需要重新填充表单数据时很有用，不过如果你使用的是 Laravel 自带的验功能，则不需要手动使用这些方法，因为一些 Laravel 自带的校验设置会自动调用它们。
将输入存储到Session
Illuminate\Http\Request 实例的 flash 方法会将当前输入存放到一次性 Session（所谓的一次性指的是从 Session 中取出数据后，对应数据会从 Session 中销毁）中，这样在下一次请求时上一次输入的数据依然有效：
$request->flash();
你还可以使用 flashOnly 和 flashExcept 方法将输入数据子集存放到 Session 中，这些方法在 Session 之外保存敏感信息时很有用，该功能适用于登录密码填写错误的场景：
$request->flashOnly('username', 'email');
$request->flashExcept('password');
将输入存储到 Session 然后重定向
如果你经常需要一次性存储输入请求输入并返回到表单填写页，可以在 redirect() 之后调用 withInput() 方法实现这样的功能：
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：
<input type="text" name="username" value="{{ old('username') }}">
这部分功能的演示待后面讲到视图和表单验证之后会提供。
Cookie
从请求中取出Cookie
为了安全起见，Laravel 框架创建的所有 Cookie 都经过加密并使用一个认证码进行签名，这意味着如果客户端修改了它们则需要对其进行有效性验证。我们使用 Illuminate\Http\Request 实例的 cookie 方法从请求中获取 Cookie 的值：
$value = $request->cookie('name');
添加Cookie到响应
你可以使用 cookie 方法将一个 Cookie 添加到返回的 Illuminate\Http\Response 实例，你需要传递 Cookie 名称、值、以及有效期（分钟）到这个方法：
return response('欢迎来到 Laravel 学院')->cookie(
'name', '学院君', $minutes
);
cookie 方法可以接收一些使用频率较低的参数，一般来说，这些参数和 PHP 原生函数 setcookie 作用和意义一致：
return response('欢迎来到 Laravel 学院')->cookie(
'name', '学院君', $minutes, $path, $domain, $secure, $httpOnly
);
我们简单演示下该功能的使用，在 routes/web.php 定义两个路由如下：
Route::get('cookie/add', function () {
$minutes = 24 * 60;
return response('欢迎来到 Laravel 学院')->cookie('name', '学院君', $minutes);
});
Route::get('cookie/get', function(\Illuminate\Http\Request $request) {
$cookie = $request->cookie('name');
dd($cookie);
});
先访问 http://blog.dev/cookie/add 设置 Cookie，然后再通过 http://blog.dev/cookie/get 获取 Cookie 值，如果在页面看到输出 学院君，则表示 Cookie 设置成功。当然我们也可以通过 Chrome 浏览器的 F12 模式快速查看 Cookie 信息：
被加密过的 name 就是我们刚刚设置的 Cookie 了。
生成Cookie实例
如果你想要生成一个 Symfony\Component\HttpFoundation\Cookie 实例以便后续添加到响应实例，可以使用全局辅助函数 cookie，该 Cookie 只有在添加到响应实例上才会发送到客户端：
$cookie = cookie('name', '学院君', $minutes);
return response('欢迎来到 Laravel 学院')->cookie($cookie);
我们改写下之前的 cookie/add 路由实现逻辑：
Route::get('cookie/add', function () {
$minutes = 24 * 60;
//return response('欢迎来到 Laravel 学院')->cookie('name', '学院君', $minutes);
$cookie = cookie('name', '学院君X', $minutes);
return response('欢迎来到 Laravel 学院')->cookie($cookie);
});
效果和之前一致，这次访问 cookie/get 路由，页面打印结果是 学院君X。
文件上传
获取上传的文件
可以使用 Illuminate\Http\Request 实例提供的 file 方法或者动态属性来访问上传文件， file 方法返回 Illuminate\Http\UploadedFile 类的一个实例，该类继承自 PHP 标准库中提供与文件交互方法的 SplFileInfo 类：
$file = $request->file('photo');
$file = $request->photo;
你可以使用 hasFile 方法判断文件在请求中是否存在：
if ($request->hasFile('photo')) {
//
验证文件是否上传成功
使用 isValid 方法判断文件在上传过程中是否出错：
if ($request->file('photo')->isValid()){
//
文件路径 & 扩展名
UploadedFile 类还提供了访问上传文件绝对路径和扩展名的方法。 extension 方法可以基于文件内容判断文件扩展名，该扩展名可能会和客户端提供的扩展名不一致：
$path = $request->photo->path();
$extension = $request->photo->extension();
其他文件方法
UploadedFile 实例上还有很多其他可用方法，查看该类的API文档了解更多信息。
保存上传的文件
要保存上传的文件，需要使用你所配置的某个文件系统，对应配置位于 config/filesystems.php：
Laravel 默认使用 local 配置存放上传文件，即本地文件系统，默认根目录是 storage/app，public 也是本地文件系统，只不过存放在这里的文件可以被公开访问，其对应的根目录是 storage/app/public，要让 Web 用户访问到该目录下存放文件的前提是在应用入口 public 目录下建一个软链 storage 链接到 storage/app/public。
UploadedFile 类有一个 store 方法，该方法会将上传文件移动到相应的磁盘路径上，该路径可以是本地文件系统的某个位置，也可以是云存储（如Amazon S3）上的路径。
store 方法接收一个文件保存的相对路径（相对于文件系统配置的根目录 ），该路径不需要包含文件名，因为系统会自动生成一个唯一ID作为文件名。
store 方法还接收一个可选的参数 —— 用于存储文件的磁盘名称作为第二个参数（对应文件系统配置 disks 的键名，默认值是 local），该方法会返回相对于根目录的文件路径：
$path = $request->photo->store('images');
$path = $request->photo->store('images', 's3');
如果你不想自动生成文件名，可以使用 storeAs 方法，该方法接收保存路径、文件名和磁盘名作为参数：
$path = $request->photo->storeAs('images', 'filename.jpg');
$path = $request->photo->storeAs('images', 'filename.jpg', 's3');
下面我们来简单演示下文件上传功能，在 routes/api.php 中定义如下文件上传路由：
Route::post('file/upload', function(\Illuminate\Http\Request $request) {
if ($request->hasFile('photo') && $request->file('photo')->isValid()) {
$photo = $request->file('photo');
$extension = $photo->extension();
//$store_result = $photo->store('photo');
$store_result = $photo->storeAs('photo', 'test.jpg');
$output = [
'extension' => $extension,
'store_result' => $store_result
];
print_r($output);exit();
exit('未获取到上传文件或上传过程出错');
});
我们还是使用 Advanced REST Client 工具来演示 POST 表单提交：
标记红圈的地方是需要重点关注的输入和输出。我分别测试了 store 方法和 storeAs 方法，上传文件成功后可以去 storage/app 目录下查看：
其他存储介质使用方式也差不多，无非是修改下 store 和 storeAs 对应的参数。在使用过程中遇到什么问题，欢迎在评论区反馈。
配置信任代理
如果你的应用运行在一个会中断 TLS/SSL 证书的负载均衡器之后，你会注意到有的时候应用不会生成 HTTPS 链接，通常这是因为应用是从负载均衡器从80端口转发过来的流量，所以不知道应该生成安全加密链接。
要解决这个问题可以使用 Laravel 5.5 新增的 App\Http\Middleware\TrustProxies 中间件，该中间件允许你快速自定义需要被应用信任的负载均衡器或代理。被信任的代理位于这个中间件的 $proxies 属性列表，除了配置信任代理之外，还可以配置代理发送的带有请求来源信息的消息头：
信任所有代理
如果你在使用 Amazon AWS 或者其他云服务提供的负载均衡，并不知道均衡器真实的 IP 地址，这种情况下，可以使用 ** 通配符信任所有代理：
/**
* The trusted proxies for this application.
* @var array
*/
protected $proxies = '**';
Laravel
文档
请求
Session
Cookie
PSR-7
文件上传
Request
教程
代理
5.5
负载均衡
请求参数
点赞
取消点赞
收藏
取消收藏
赞赏
分享到以下平台：
<< 上一篇:
HTTP 请求的处理层：控制器
>> 下一篇:
HTTP 响应、重定向及文件下载
19 条评论
#11
loseself
评论于 4年前
正在删除评论...
学院君, 云储存, 走服务器吗? 还是用户直接传到云上, 不用先传到服务器, 再传到云.
#12
yang-li
评论于 4年前
正在删除评论...
可以的，不用走服务器
#13
无心
评论于 4年前
正在删除评论...
如果看的时候困难，最好进行操作一下，会帮助理解
#14
新手
评论于 4年前
正在删除评论...
第一次玩，好紧张
#15
dancheng99
评论于 4年前
正在删除评论...
Route::get('cookie/add', function () {
$minutes = 24 * 60;
return response('欢迎来到 Laravel 学院')->cookie('name', '学院君', $minutes);
});
Route::get('cookie/get', function(\Illuminate\Http\Request $request) {
$cookie = $request->cookie('name');
dd($cookie);
});
我的到的cookie是 null 为什么
#16
JensonC
评论于 4年前
回复 #7
正在删除评论...
看一百遍不如动手敲一遍
#17
学院君
评论于 4年前
回复 #16
正在删除评论...
可惜有这个觉悟的不多啊
#18
yang
评论于 3年前
正在删除评论...
我上传.docx文档的时候，为什么有的上传成功了自动给转成.zip压缩包的格式了？有遇到跟我一样问题的吗？
#19
xiaoyukarl
评论于 2年前
正在删除评论...
今天遇到一个问题，上传excel文件未获取到正确扩展名
$request->file->extension(); //.xlsx文件，获取到扩展名为zip
$request->file->getClientOriginalExtension();//改用此方法获取到正确的扩展名
&lsaquo;
&rsaquo;
登录后即可添加评论
升级为学院君订阅用户(新年优惠🎁)
内容导航
访问请求实例
请求路径 & 方法
PSR-7 请求
请求字符串处理
获取请求输入
上一次请求输入
Cookie
文件上传
获取上传的文件
保存上传的文件
配置信任代理
相关推荐
请求
Laravel 5.4 中文文档
基础组件
HTTP 请求
Laravel 5.6 中文文档
基础组件
HTTP 请求
Laravel 5.7 中文文档
基础组件
HTTP 请求
Laravel 5.8 中文文档
基础组件
HTTP 请求
Laravel 6 中文文档
基础组件
回到顶部
2022 基于 Laravel 6 构建
关于学院
订阅服务
友情链接
站点地图
本站 CDN 加速服务由又拍云赞助