HTTP 请求

简介
与请求交互
输入
文件
- 检索上传的文件
- 存储上传的文件
配置可信代理
配置可信主机

简介

Laravel 的 Illuminate\Http\Request 类提供了一种面向对象的方式与当前应用程序处理的 HTTP 请求进行交互，并检索随请求提交的输入、cookies 和文件。

与请求交互

访问请求

要通过依赖注入获取当前 HTTP 请求的实例，您应该在路由闭包或控制器方法中类型提示 Illuminate\Http\Request 类。传入的请求实例将由 Laravel 服务容器自动注入：

php

<?php

namespace App\Http\Controllers;

use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;

class UserController extends Controller
{
    /**
     * 存储一个新用户。
     */
    public function store(Request $request): RedirectResponse
    {
        $name = $request->input('name');

        // 存储用户...

        return redirect('/users');
    }
}

如上所述，您也可以在路由闭包中类型提示 Illuminate\Http\Request 类。服务容器会在闭包执行时自动将传入请求注入：

php

use Illuminate\Http\Request;

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

依赖注入与路由参数

如果您的控制器方法也期望从路由参数获取输入，您应该在其他依赖项之后列出路由参数。例如，如果您的路由定义如下：

php

use App\Http\Controllers\UserController;

Route::put('/user/{id}', [UserController::class, 'update']);

您仍然可以类型提示 Illuminate\Http\Request，并通过如下定义控制器方法来访问 id 路由参数：

php

<?php

namespace App\Http\Controllers;

use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;

class UserController extends Controller
{
    /**
     * 更新指定的用户。
     */
    public function update(Request $request, string $id): RedirectResponse
    {
        // 更新用户...

        return redirect('/users');
    }
}

请求路径、主机和方法

Illuminate\Http\Request 实例提供了多种检查传入 HTTP 请求的方法，并扩展了 Symfony\Component\HttpFoundation\Request 类。下面我们将讨论一些最重要的方法。

检索请求路径

path 方法返回请求的路径信息。因此，如果传入请求的目标是 http://example.com/foo/bar，那么 path 方法将返回 foo/bar：

php

$uri = $request->path();

检查请求路径/路由

is 方法允许您验证传入请求路径是否与给定模式匹配。使用此方法时，您可以使用 * 字符作为通配符：

php

if ($request->is('admin/*')) {
    // ...
}

使用 routeIs 方法，您可以确定传入请求是否匹配了命名路由：

php

if ($request->routeIs('admin.*')) {
    // ...
}

检索请求 URL

要检索传入请求的完整 URL，您可以使用 url 或 fullUrl 方法。url 方法返回不带查询字符串的 URL，而 fullUrl 方法包含查询字符串：

php

$url = $request->url();

$urlWithQueryString = $request->fullUrl();

如果您想将查询字符串数据附加到当前 URL，可以调用 fullUrlWithQuery 方法。此方法将给定的查询字符串变量数组与当前查询字符串合并：

php

$request->fullUrlWithQuery(['type' => 'phone']);

如果您想获取不带给定查询字符串参数的当前 URL，可以使用 fullUrlWithoutQuery 方法：

php

$request->fullUrlWithoutQuery(['type']);

检索请求主机

您可以通过 host、httpHost 和 schemeAndHttpHost 方法检索传入请求的“主机”：

php

$request->host();
$request->httpHost();
$request->schemeAndHttpHost();

检索请求方法

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

php

$method = $request->method();

if ($request->isMethod('post')) {
    // ...
}

请求头

您可以使用 header 方法从 Illuminate\Http\Request 实例检索请求头。如果请求中不存在该头，将返回 null。但是，header 方法接受一个可选的第二个参数，如果请求中不存在该头，将返回该值：

php

$value = $request->header('X-Header-Name');

$value = $request->header('X-Header-Name', 'default');

hasHeader 方法可用于确定请求是否包含给定头：

php

if ($request->hasHeader('X-Header-Name')) {
    // ...
}

为了方便，bearerToken 方法可用于从 Authorization 头中检索不记名令牌。如果不存在此类头，将返回空字符串：

php

$token = $request->bearerToken();

请求 IP 地址

ip 方法可用于检索向您的应用程序发出请求的客户端的 IP 地址：

php

$ipAddress = $request->ip();

如果您想检索 IP 地址数组，包括由代理转发的所有客户端 IP 地址，您可以使用 ips 方法。“原始”客户端 IP 地址将位于数组的末尾：

php

$ipAddresses = $request->ips();

一般来说，IP 地址应被视为不受信任的、用户控制的输入，仅用于信息目的。

内容协商

Laravel 提供了几种方法，通过 Accept 头检查传入请求请求的内容类型。首先，getAcceptableContentTypes 方法将返回一个数组，包含请求接受的所有内容类型：

php

$contentTypes = $request->getAcceptableContentTypes();

accepts 方法接受一个内容类型数组，如果请求接受其中任何一种内容类型，则返回 true。否则，返回 false：

php

if ($request->accepts(['text/html', 'application/json'])) {
    // ...
}

您可以使用 prefers 方法确定在给定的内容类型数组中，请求最偏好哪一种。如果请求不接受提供的任何一种内容类型，则返回 null：

php

$preferred = $request->prefers(['text/html', 'application/json']);

由于许多应用程序仅提供 HTML 或 JSON，您可以使用 expectsJson 方法快速确定传入请求是否期望 JSON 响应：

php

if ($request->expectsJson()) {
    // ...
}

如果你需要判断请求是否特别偏好 Markdown，或者在其他内容类型中是否接受 Markdown，例如在为 AI 代理或其他使用 Markdown 响应的客户端提供服务时，你可以使用 wantsMarkdown 和 acceptsMarkdown 方法：

php

if ($request->wantsMarkdown()) {
    // 客户端最偏好的内容类型是 text/markdown...
}

if ($request->acceptsMarkdown()) {
    // 客户端接受 Markdown 响应...
}

PSR-7 请求

PSR-7 标准规定了 HTTP 消息的接口，包括请求和响应。如果您希望获得 PSR-7 请求的实例而不是 Laravel 请求，您首先需要安装几个库。Laravel 使用 Symfony HTTP 消息桥接 组件将典型的 Laravel 请求和响应转换为 PSR-7 兼容的实现：

shell

composer require symfony/psr-http-message-bridge
composer require nyholm/psr7

安装这些库后，您可以通过在路由闭包或控制器方法中类型提示请求接口来获取 PSR-7 请求：

php

use Psr\Http\Message\ServerRequestInterface;

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

NOTE

如果您从路由或控制器返回 PSR-7 响应实例，它将自动转换回 Laravel 响应实例并由框架显示。

输入

检索输入

检索所有输入数据

您可以使用 all 方法将传入请求的所有输入数据作为 array 检索。无论传入请求来自 HTML 表单还是 XHR 请求，都可以使用此方法：

php

$input = $request->all();

使用 collect 方法，您可以将传入请求的所有输入数据作为集合检索：

php

$input = $request->collect();

collect 方法还允许您将传入请求的一部分输入作为集合检索：

php

$request->collect('users')->each(function (string $user) {
    // ...
});

检索单个输入值

使用几个简单的方法，您可以从 Illuminate\Http\Request 实例访问所有用户输入，而不必担心请求使用了哪个 HTTP 动词。无论 HTTP 动词如何，input 方法都可用于检索用户输入：

php

$name = $request->input('name');

您可以将默认值作为第二个参数传递给 input 方法。如果请求中不存在请求的输入值，将返回此值：

php

$name = $request->input('name', 'Sally');

处理包含数组输入的表单时，使用“点”表示法访问数组：

php

$name = $request->input('products.0.name');

$names = $request->input('products.*.name');

您可以不带任何参数调用 input 方法，以关联数组的形式检索所有输入值：

php

$input = $request->input();

从查询字符串检索输入

input 方法从整个请求负载（包括查询字符串）中检索值，而 query 方法将仅从查询字符串中检索值：

php

$name = $request->query('name');

如果请求的查询字符串值数据不存在，将返回此方法的第二个参数：

php

$name = $request->query('name', 'Helen');

您可以不带任何参数调用 query 方法，以关联数组的形式检索所有查询字符串值：

php

$query = $request->query();

检索 JSON 输入值

当向您的应用程序发送 JSON 请求时，只要请求的 Content-Type 头正确设置为 application/json，您就可以通过 input 方法访问 JSON 数据。您甚至可以使用“点”语法检索嵌套在 JSON 数组/对象中的值：

php

$name = $request->input('user.name');

检索 Stringable 输入值

您可以使用 string 方法将请求的输入数据作为 Illuminate\Support\Stringable 实例检索，而不是作为原始的 string：

php

$name = $request->string('name')->trim();

检索整数输入值

要将输入值检索为整数，您可以使用 integer 方法。此方法会尝试将输入值转换为整数。如果输入不存在或转换失败，它将返回您指定的默认值。这对于分页或其他数字输入特别有用：

php

$perPage = $request->integer('per_page');

检索布尔输入值

处理诸如复选框之类的 HTML 元素时，您的应用程序可能会收到实际上是字符串的“真值”。例如，"true" 或 "on"。为了方便，您可以使用 boolean 方法将这些值作为布尔值检索。boolean 方法对于 1、"1"、true、"true"、"on" 和 "yes" 返回 true。所有其他值将返回 false：

php

$archived = $request->boolean('archived');

检索数组输入值

包含数组的输入值可以使用 array 方法检索。此方法始终将输入值强制转换为数组。如果请求不包含具有给定名称的输入值，将返回一个空数组：

php

$versions = $request->array('versions');

检索日期输入值

为了方便，包含日期/时间的输入值可以使用 date 方法作为 Carbon 实例检索。如果请求不包含具有给定名称的输入值，将返回 null：

php

$birthday = $request->date('birthday');

date 方法接受的第二个和第三个参数可分别用于指定日期的格式和时区：

php

$elapsed = $request->date('elapsed', '!H:i', 'Europe/Madrid');

如果输入值存在但格式无效，将抛出 InvalidArgumentException；因此，建议您在调用 date 方法之前验证输入。

获取间隔输入值

包含持续时间的输入值可以使用 interval 方法作为 CarbonInterval 实例获取。如果请求中不存在指定名称的输入值，将返回 null：

php

$duration = $request->interval('duration');

如果输入值是数字，你可以将单位作为第二个参数提供。单位可以是字符串，如 second、minute 或 day，也可以是 Carbon\Unit 枚举实例：

php

use Carbon\Unit;

$timeout = $request->interval('timeout', 'second');

$delay = $request->interval('delay', Unit::Minute);

如果输入值存在但格式无效，将抛出 InvalidArgumentException；因此，建议在调用 interval 方法之前先验证输入。

检索 Enum 输入值

对应于 PHP 枚举的输入值也可以从请求中检索。如果请求不包含具有给定名称的输入值，或者枚举没有与输入值匹配的标量值，将返回 null。enum 方法接受输入值的名称和枚举类作为其第一和第二个参数：

php

use App\Enums\Status;

$status = $request->enum('status', Status::class);

您还可以提供一个默认值，如果值缺失或无效，将返回该值：

php

$status = $request->enum('status', Status::class, Status::Pending);

如果输入值是一个对应于 PHP 枚举的值数组，您可以使用 enums 方法将该值数组作为枚举实例数组检索：

php

use App\Enums\Product;

$products = $request->enums('products', Product::class);

通过动态属性检索输入

您还可以使用 Illuminate\Http\Request 实例上的动态属性访问用户输入。例如，如果您的应用程序的表单包含一个 name 字段，您可以像这样访问该字段的值：

php

$name = $request->name;

使用动态属性时，Laravel 会首先在请求负载中查找参数的值。如果不存在，Laravel 将在匹配的路由参数中搜索该字段。

检索部分输入数据

如果您需要检索输入数据的子集，可以使用 only 和 except 方法。这两种方法都接受单个 array 或动态参数列表：

php

$input = $request->only(['username', 'password']);

$input = $request->only('username', 'password');

$input = $request->except(['credit_card']);

$input = $request->except('credit_card');

WARNING

only 方法返回您请求的所有键/值对；但是，它不会返回请求中不存在的键/值对。

输入的存在性

您可以使用 has 方法确定值是否存在于请求中。如果值存在于请求中，has 方法返回 true：

php

if ($request->has('name')) {
    // ...
}

当给定一个数组时，has 方法将确定所有指定的值是否存在：

php

if ($request->has(['name', 'email'])) {
    // ...
}

hasAny 方法如果任何指定的值存在，则返回 true：

php

if ($request->hasAny(['name', 'email'])) {
    // ...
}

whenHas 方法将在值存在于请求中时执行给定的闭包：

php

$request->whenHas('name', function (string $input) {
    // ...
});

可以向 whenHas 方法传递第二个闭包，如果指定值不存在于请求中，将执行该闭包：

php

$request->whenHas('name', function (string $input) {
    // "name" 值存在...
}, function () {
    // "name" 值不存在...
});

如果您想确定值是否存在于请求中且不是空字符串，可以使用 filled 方法：

php

if ($request->filled('name')) {
    // ...
}

如果您想确定值是否缺失于请求中或是空字符串，可以使用 isNotFilled 方法：

php

if ($request->isNotFilled('name')) {
    // ...
}

当给定一个数组时，isNotFilled 方法将确定所有指定的值是否缺失或为空：

php

if ($request->isNotFilled(['name', 'email'])) {
    // ...
}

anyFilled 方法如果任何指定的值不是空字符串，则返回 true：

php

if ($request->anyFilled(['name', 'email'])) {
    // ...
}

whenFilled 方法将在值存在于请求中且不是空字符串时执行给定的闭包：

php

$request->whenFilled('name', function (string $input) {
    // ...
});

可以向 whenFilled 方法传递第二个闭包，如果指定值不是“已填充”的，将执行该闭包：

php

$request->whenFilled('name', function (string $input) {
    // "name" 值已填充...
}, function () {
    // "name" 值未填充...
});

要确定给定键是否缺失于请求中，您可以使用 missing 和 whenMissing 方法：

php

if ($request->missing('name')) {
    // ...
}

$request->whenMissing('name', function () {
    // "name" 值缺失...
}, function () {
    // "name" 值存在...
});

合并附加输入

有时您可能需要手动将附加输入合并到请求的现有输入数据中。为此，您可以使用 merge 方法。如果给定的输入键已存在于请求中，它将被提供给 merge 方法的数据覆盖：

php

$request->merge(['votes' => 0]);

mergeIfMissing 方法可用于在请求输入数据中尚不存在相应键的情况下将输入合并到请求中：

php

$request->mergeIfMissing(['votes' => 0]);

旧输入

Laravel 允许您在一次请求期间保留输入，以便在下一次请求中使用。此功能对于在检测到验证错误后重新填充表单特别有用。但是，如果您使用 Laravel 附带的验证功能，您可能不需要直接手动使用这些会话输入闪存方法，因为 Laravel 的一些内置验证工具会自动调用它们。

将输入闪存到会话

Illuminate\Http\Request 类上的 flash 方法会将当前输入闪存到会话，以便在用户下一次向应用程序发出请求时可用：

php

$request->flash();

您还可以使用 flashOnly 和 flashExcept 方法将请求数据的子集闪存到会话。这些方法对于将敏感信息（如密码）排除在会话之外很有用：

php

$request->flashOnly(['username', 'email']);

$request->flashExcept('password');

闪存输入然后重定向

由于您经常希望将输入闪存到会话，然后重定向到上一个页面，您可以使用 withInput 方法轻松地将输入闪存链接到重定向上：

php

return redirect('/form')->withInput();

return redirect()->route('user.create')->withInput();

return redirect('/form')->withInput(
    $request->except('password')
);

检索旧输入

要从上一次请求中检索闪存的输入，请在 Illuminate\Http\Request 实例上调用 old 方法。old 方法将从会话中提取先前闪存的输入数据：

php

$username = $request->old('username');

Laravel 还提供了一个全局 old 辅助函数。如果您在 Blade 模板中显示旧输入，使用 old 辅助函数重新填充表单更方便。如果给定字段不存在旧输入，将返回 null：

blade

<input type="text" name="username" value="{{ old('username') }}">

Cookies

从请求中检索 Cookies

由 Laravel 框架创建的所有 cookies 都经过加密并使用身份验证代码签名，这意味着如果客户端更改了它们，它们将被视为无效。要从请求中检索 cookie 值，请在 Illuminate\Http\Request 实例上使用 cookie 方法：

php

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

输入修剪与规范化

默认情况下，Laravel 在应用程序的全局中间件栈中包含了 Illuminate\Foundation\Http\Middleware\TrimStrings 和 Illuminate\Foundation\Http\Middleware\ConvertEmptyStringsToNull 中间件。这些中间件会自动修剪请求中所有传入的字符串字段，并将任何空字符串字段转换为 null。这样您就不必在路由和控制器中担心这些规范化问题。

禁用输入规范化

如果您想对所有请求禁用此行为，您可以在应用程序的 bootstrap/app.php 文件中通过调用 $middleware->remove 方法从应用程序的中间件栈中移除这两个中间件：

php

use Illuminate\Foundation\Http\Middleware\ConvertEmptyStringsToNull;
use Illuminate\Foundation\Http\Middleware\TrimStrings;

->withMiddleware(function (Middleware $middleware): void {
    $middleware->remove([
        ConvertEmptyStringsToNull::class,
        TrimStrings::class,
    ]);
})

如果您想对一部分应用程序请求禁用字符串修剪和空字符串转换，您可以在应用程序的 bootstrap/app.php 文件中使用 trimStrings 和 convertEmptyStringsToNull 中间件方法。这两种方法都接受一个闭包数组，闭包应返回 true 或 false 来指示是否应跳过输入规范化：

php

->withMiddleware(function (Middleware $middleware): void {
    $middleware->convertEmptyStringsToNull(except: [
        fn (Request $request) => $request->is('admin/*'),
    ]);

    $middleware->trimStrings(except: [
        fn (Request $request) => $request->is('admin/*'),
    ]);
})

文件

检索上传的文件

您可以使用 file 方法或使用动态属性从 Illuminate\Http\Request 实例检索上传的文件。file 方法返回 Illuminate\Http\UploadedFile 类的实例，该类扩展了 PHP 的 SplFileInfo 类，并提供了各种与文件交互的方法：

php

$file = $request->file('photo');

$file = $request->photo;

您可以使用 hasFile 方法确定请求中是否存在文件：

php

if ($request->hasFile('photo')) {
    // ...
}

验证成功上传

除了检查文件是否存在外，您还可以通过 isValid 方法验证文件上传是否没有出现问题：

php

if ($request->file('photo')->isValid()) {
    // ...
}

文件路径和扩展名

UploadedFile 类还包含用于访问文件的完整路径及其扩展名的方法。extension 方法将尝试根据文件内容猜测文件的扩展名。此扩展名可能与客户端提供的扩展名不同：

php

$path = $request->photo->path();

$extension = $request->photo->extension();

其他文件方法

UploadedFile 实例上还有各种其他方法可用。查看该类的 API 文档以获取有关这些方法的更多信息。

存储上传的文件

要存储上传的文件，您通常会使用您配置的文件系统之一。UploadedFile 类有一个 store 方法，该方法会将上传的文件移动到您的某个磁盘上，该磁盘可以是本地文件系统上的位置，也可以是像 Amazon S3 这样的云存储位置。

store 方法接受文件应存储的路径，该路径相对于文件系统配置的根目录。此路径不应包含文件名，因为会自动生成一个唯一 ID 作为文件名。

store 方法还接受一个可选的第二个参数，用于指定存储文件时应使用的磁盘名称。该方法将返回相对于磁盘根目录的文件路径：

php

$path = $request->photo->store('images');

$path = $request->photo->store('images', 's3');

如果您不希望自动生成文件名，可以使用 storeAs 方法，该方法接受路径、文件名和磁盘名称作为其参数：

php

$path = $request->photo->storeAs('images', 'filename.jpg');

$path = $request->photo->storeAs('images', 'filename.jpg', 's3');

NOTE

有关 Laravel 中文件存储的更多信息，请查看完整的文件存储文档。

配置可信代理

当您的应用程序在终止 TLS / SSL 证书的负载均衡器后面运行时，您可能会注意到您的应用程序在使用 url 辅助函数时有时不会生成 HTTPS 链接。通常这是因为您的应用程序从负载均衡器通过 80 端口转发流量，并且不知道它应该生成安全链接。

为了解决这个问题，您可以启用 Laravel 应用程序中包含的 Illuminate\Http\Middleware\TrustProxies 中间件，它允许您快速自定义应用程序应信任的负载均衡器或代理。您应该使用应用程序的 bootstrap/app.php 文件中的 trustProxies 中间件方法指定您的可信代理：

php

->withMiddleware(function (Middleware $middleware): void {
    $middleware->trustProxies(at: [
        '192.168.1.1',
        '10.0.0.0/8',
    ]);
})

除了配置可信代理，您还可以配置应信任的代理头：

php

->withMiddleware(function (Middleware $middleware): void {
    $middleware->trustProxies(headers: Request::HEADER_X_FORWARDED_FOR |
        Request::HEADER_X_FORWARDED_HOST |
        Request::HEADER_X_FORWARDED_PORT |
        Request::HEADER_X_FORWARDED_PROTO |
        Request::HEADER_X_FORWARDED_AWS_ELB
    );
})

NOTE

如果您使用 AWS Elastic Load Balancing，headers 值应为 Request::HEADER_X_FORWARDED_AWS_ELB。如果您的负载均衡器使用 RFC 7239 中的标准 Forwarded 头，headers 值应为 Request::HEADER_FORWARDED。有关 headers 值中可能使用的常量的更多信息，请查看 Symfony 关于信任代理的文档。

信任所有代理

如果您使用 Amazon AWS 或其他“云”负载均衡器提供商，您可能不知道实际负载均衡器的 IP 地址。在这种情况下，您可以使用 * 来信任所有代理：

php

->withMiddleware(function (Middleware $middleware): void {
    $middleware->trustProxies(at: '*');
})

配置可信主机

默认情况下，Laravel 会响应它收到的所有请求，无论 HTTP 请求的 Host 头内容如何。此外，在 Web 请求期间，Host 头的值将用于生成指向您的应用程序的绝对 URL。

通常，您应该配置您的 Web 服务器（如 Nginx 或 Apache），使其仅将匹配给定主机名的请求发送到您的应用程序。但是，如果您无法直接自定义 Web 服务器，并且需要指示 Laravel 仅响应某些主机名，您可以通过为您的应用程序启用 Illuminate\Http\Middleware\TrustHosts 中间件来实现。

要启用 TrustHosts 中间件，您应该在应用程序的 bootstrap/app.php 文件中调用 trustHosts 中间件方法。使用此方法的 at 参数，您可以指定应用程序应响应的主机名。主机名字符串被视为正则表达式。具有其他 Host 头的传入请求将被拒绝：

php

->withMiddleware(function (Middleware $middleware): void {
    $middleware->trustHosts(at: ['^laravel\.test$']);
})

默认情况下，来自应用程序 URL 子域的请求也会自动被信任。如果您想禁用此行为，可以使用 subdomains 参数：

php

->withMiddleware(function (Middleware $middleware): void {
    $middleware->trustHosts(at: ['^laravel\.test$'], subdomains: false);
})

如果您需要访问应用程序的配置文件或数据库来确定您的可信主机，您可以向 at 参数提供一个闭包：

php

->withMiddleware(function (Middleware $middleware): void {
    $middleware->trustHosts(at: fn () => config('app.trusted_hosts'));
})

HTTP 请求 ​

简介 ​

与请求交互 ​

访问请求 ​

依赖注入与路由参数 ​

请求路径、主机和方法 ​

检索请求路径 ​

检查请求路径/路由 ​

检索请求 URL ​

检索请求主机 ​

检索请求方法 ​

请求头 ​

请求 IP 地址 ​

内容协商 ​

PSR-7 请求 ​

输入 ​

检索输入 ​

检索所有输入数据 ​

检索单个输入值 ​

从查询字符串检索输入 ​

检索 JSON 输入值 ​

检索 Stringable 输入值 ​

检索整数输入值 ​

检索布尔输入值 ​

检索数组输入值 ​

检索日期输入值 ​

获取间隔输入值 ​

检索 Enum 输入值 ​

通过动态属性检索输入 ​

检索部分输入数据 ​

输入的存在性 ​

合并附加输入 ​

旧输入 ​

将输入闪存到会话 ​

闪存输入然后重定向 ​

检索旧输入 ​

Cookies ​

从请求中检索 Cookies ​

输入修剪与规范化 ​

禁用输入规范化 ​

文件 ​

检索上传的文件 ​

验证成功上传 ​

文件路径和扩展名 ​

其他文件方法 ​

存储上传的文件 ​

配置可信代理 ​

信任所有代理 ​

配置可信主机 ​

HTTP 请求

简介

与请求交互

访问请求

依赖注入与路由参数

请求路径、主机和方法

检索请求路径

检查请求路径/路由

检索请求 URL

检索请求主机

检索请求方法

请求头

请求 IP 地址

内容协商

PSR-7 请求

输入

检索输入

检索所有输入数据

检索单个输入值

从查询字符串检索输入

检索 JSON 输入值

检索 Stringable 输入值

检索整数输入值

检索布尔输入值

检索数组输入值

检索日期输入值

获取间隔输入值

检索 Enum 输入值

通过动态属性检索输入

检索部分输入数据

输入的存在性

合并附加输入

旧输入

将输入闪存到会话

闪存输入然后重定向

检索旧输入

Cookies

从请求中检索 Cookies

输入修剪与规范化

禁用输入规范化

文件

检索上传的文件

验证成功上传

文件路径和扩展名

其他文件方法

存储上传的文件

配置可信代理

信任所有代理

配置可信主机