Giới thiệu

Class Illuminate\Http\Request của Laravel cung cấp một cách hướng đối tượng để tương tác với các request HTTP hiện tại đang được ứng dụng của bạn xử lý cũng như truy xuất dữ liệu input, cookie và các file đã được gửi cùng với request.

Tương tác với request

Truy cập vào Request

Để có được một instance của request HTTP thông qua việc khai báo phụ thuộc, bạn có thể khai báo kiểu class Illuminate\Http\Request trong route closure hoặc phương thức controller của bạn. Instance của request sẽ tự động được inject bởi Laravel service container:

<?php

namespace App\Http\Controllers;

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

class UserController extends Controller
{
    /**
     * Store a new user.
     */
    public function store(Request $request): RedirectResponse
    {
        $name = $request->input('name');

        // Store the user...

        return redirect('/users');
    }
}

Như đã đề cập, bạn cũng có thể khai báo kiểu class Illuminate\Http\Request trong một route Closure. Service container sẽ tự động inject request vào Closure khi được thực thi:

use Illuminate\Http\Request;

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

Dependency Injection và Route Parameters

Nếu phương thức controller của bạn cũng đang yêu cầu input từ một tham số route, bạn nên liệt kê các tham số route đó đằng sau các phụ thuộc. Ví dụ: nếu route của bạn được định nghĩa như sau:

use App\Http\Controllers\UserController;

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

Bạn vẫn có thể khai báo kiểu Illuminate\Http\Request và truy cập vào tham số id của route bằng cách định nghĩa phương thức controller như sau:

<?php

namespace App\Http\Controllers;

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

class UserController extends Controller
{
    /**
     * Update the specified user.
     */
    public function update(Request $request, string $id): RedirectResponse
    {
        // Update the user...

        return redirect('/users');
    }
}

Request Path, Host, và Method

Instance Illuminate\Http\Request cung cấp nhiều phương thức để kiểm tra HTTP request đến và nó được extend từ class Symfony\Component\HttpFoundation\Request. Chúng tôi sẽ nói về một số phương thức quan trọng dưới đây.

Lấy Request Path

Phương thức path trả về thông tin path của request. Vì vậy, nếu request được targeted là http://example.com/foo/bar, thì phương thức path sẽ trả về foo/bar:

$uri = $request->path();

Inspecting The Request Path / Route

Phương thức is cho phép bạn kiểm tra path của request có khớp với một pattern đã cho hay không. Bạn có thể sử dụng ký tự * làm ký tự đại diện khi sử dụng phương thức này:

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

Bằng cách sử dụng phương thức routeIs, bạn có thể xác định xem request đến có khớp với tên của một route hay không:

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

Lấy Request URL

Để lấy full URL của request, bạn có thể sử dụng các phương thức url hoặc fullUrl. Phương thức url sẽ trả về URL mà không có chuỗi truy vấn, trong khi phương thức fullUrl sẽ bao gồm chuỗi truy vấn:

$url = $request->url();

$urlWithQueryString = $request->fullUrl();

Nếu bạn muốn nối thêm biến vào URL hiện tại, bạn có thể gọi phương thức fullUrlWithQuery. Phương thức này sẽ nối một mảng các biến đã cho vào các biến hiện tại:

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

Nếu bạn muốn lấy URL hiện tại mà không cần đến các tham số chuỗi truy vấn, thì bạn có thể sử dụng phương thức fullUrlWithoutQuery:

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

Retrieving The Request Host

Bạn có thể lấy ra "host" của request đến thông qua các phương thức host, httpHost và schemeAndHttpHost:

// http://localhost:8000
$request->host(); // localhost
$request->httpHost(); // localhost:8000
$request->schemeAndHttpHost(); // http://localhost:8000

Lấy Request Method

Phương thức method sẽ trả về mothed HTTP của request. Bạn có thể sử dụng phương thức isMethod để kiểm tra mothed HTTP có khớp với một chuỗi đã cho hay không:

$method = $request->method();

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

Request Headers

Bạn có thể lấy ra header của request từ instance Illuminate\Http\Request bằng phương thức header. Nếu header không tồn tại trong request, null sẽ được trả về. Tuy nhiên, phương thức header cũng chấp nhận tham số thứ hai tùy chọn sẽ được trả về nếu header không có trong request:

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

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

Phương thức hasHeader có thể được sử dụng để xác định xem request có chứa header nhất định hay không:

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

Để thuận tiện, phương thức bearerToken có thể được sử dụng để lấy ra mã token từ header Authorization. Nếu không có header nào như vậy, một chuỗi trống sẽ được trả về:

$token = $request->bearerToken();

Request IP Address

Phương thức ip có thể được sử dụng để lấy ra địa chỉ IP của client đã gửi request tới ứng dụng của bạn:

$ipAddress = $request->ip();

Nếu bạn muốn lấy ra một mảng các địa chỉ IP, bao gồm tất cả các địa chỉ IP của client được chuyển qua bởi proxy, bạn có thể sử dụng phương thức ips. Địa chỉ IP của client "gốc" sẽ nằm ở cuối mảng:

$ipAddresses = $request->ips();

Nhìn chung, địa chỉ IP nên được coi là dữ liệu input không đáng tin cậy, bởi vì người dùng kiểm soát thông tin này và chỉ được sử dụng cho mục đích thông tin.

Content Negotiation

Laravel cung cấp một số phương thức để kiểm tra các content type được yêu cầu bởi request gửi đến thông qua header Accept. Đầu tiên, phương thức getAcceptableContentTypes sẽ trả về một mảng chứa tất cả các content type được request chấp nhận:

$contentTypes = $request->getAcceptableContentTypes();

Phương thức accepts sẽ chấp nhận một mảng các content type và sẽ trả về true nếu có bất kỳ content type nào được chấp nhận bởi request. Nếu không, false sẽ được trả về:

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

Bạn có thể sử dụng phương thức prefers để xác định xem content type nào có trong một mảng content type được request ưu tiên hơn. Nếu không có content type nào được request chấp nhận, null sẽ được trả về:

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

Vì nhiều ứng dụng chỉ cần HTML hoặc JSON nên bạn có thể sử dụng phương thức expectsJson để nhanh chóng xác định xem request đến có yêu cầu response JSON hay không:

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

Nếu bạn cần xác định xem request có ưu tiên Markdown hay chỉ chấp nhận Markdown nằm trong một số định dạng được chấp nhận hay không, bạn có thể sử dụng phương thức wantsMarkdown và acceptsMarkdown, chẳng hạn như khi chạy các AI agent hoặc các client khác sử dụng response Markdown:

if ($request->wantsMarkdown()) {
    // The client's most preferred content type is text/markdown...
}

if ($request->acceptsMarkdown()) {
    // The client accepts Markdown responses...
}

PSR-7 Requests

Tiêu chuẩn PSR-7 định nghĩa interface cho các message HTTP, bao gồm cả các request và response. Nếu bạn muốn có một instance của PSR-7 request thay vì Laravel request, trước tiên bạn sẽ cần cài đặt một vài thư viện. Laravel sẽ sử dụng component Symfony HTTP Message Bridge để chuyển đổi các request và response của Laravel thành các implementation tương thích PSR-7:

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

Khi bạn đã cài đặt xong các thư viện trên, bạn có thể lấy được PSR-7 request bằng cách khai báo kiểu request interface trên vào route closure hoặc controller method:

use Psr\Http\Message\ServerRequestInterface;

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

[!NOTE] Nếu bạn muốn trả về một instance response PSR-7 từ một route hoặc một controller, nó sẽ tự động được chuyển đổi trở lại thành một instance response Laravel và được hiển thị bởi framework.

Input

Lấy Input

Lấy tất cả Input Data

Bạn có thể lấy ra tất cả các dữ liệu input của incoming request dưới dạng một array bằng cách sử dụng phương thức all. Phương thức này có thể được sử dụng bất kể incoming request là từ HTML form hay là request XHR:

$input = $request->all();

Bằng cách sử dụng phương thức collect, bạn có thể lấy ra tất cả dữ liệu input của incoming request dưới dạng một collection:

$input = $request->collect();

Phương thức collect cũng cho phép bạn lấy ra một tập con của input của incoming request dưới dạng một collection:

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

Lấy một Input Value

Sử dụng một vài phương thức đơn giản sau đây, bạn có thể truy cập tất cả các input của người dùng từ instance Illuminate\Http\Request của bạn mà không cần lo lắng về method HTTP nào được sử dụng cho request. Bất kể method HTTP nào, phương thức input có thể được sử dụng để lấy dữ liệu mà người dùng đã nhập:

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

Bạn có thể truyền vào một giá trị mặc định làm tham số thứ hai cho phương thức input. Giá trị này sẽ được trả về nếu giá trị input trong request không tồn tại:

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

Khi làm việc với các form có chứa một mảng input, hãy sử dụng ký tự "chấm" để truy cập vào mảng:

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

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

Bạn có thể gọi phương thức input mà không có bất kỳ tham số nào để lấy ra tất cả các giá trị input dưới dạng một mảng:

$input = $request->input();

Lấy Input từ Query String

Trong khi phương thức input lấy ra các giá trị từ toàn bộ request (bao gồm cả query string), thì phương thức query sẽ chỉ lấy các giá trị từ query string:

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

Nếu như không tồn tại giá trị trong query string, tham số thứ hai của phương thức này sẽ được trả về:

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

Bạn có thể gọi phương thức query mà không có bất kỳ tham số nào để lấy ra tất cả các giá trị query string dưới dạng một mảng:

$query = $request->query();

Lấy JSON Input Values

Khi gửi các JSON request cho application của bạn, bạn có thể truy cập dữ liệu JSON thông qua phương thức input miễn là Content-Type header của request đó được set là application/json. Bạn thậm chí có thể sử dụng cú pháp "chấm" để lấy ra các phần tử con trong mảng JSON hoặc object:

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

Retrieving Stringable Input Values

Thay vì lấy dữ liệu input của request dưới dạng string đơn giản, bạn có thể sử dụng phương thức string để lấy dữ liệu request dưới dạng một instance của Illuminate\Support\Stringable:

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

Retrieving Integer Input Values

Để lấy ra các giá trị input dưới dạng số nguyên, bạn có thể sử dụng phương thức integer. Phương thức này sẽ cố gắng cast kiểu giá trị input thành số nguyên. Nếu input không tồn tại hoặc việc cast kiểu thất bại, nó sẽ trả về giá trị mặc định mà bạn chỉ định. Điều này đặc biệt hữu ích cho việc phân trang hoặc các input các số numeric khác:

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

Lấy giá trị input là boolean

Khi xử lý các phần tử HTML như checkbox, ứng dụng của bạn có thể nhận vào các giá trị "truthy" là các chuỗi chứ không phải dạng boolean. Ví dụ: "true" hoặc "on". Để thuận tiện, bạn có thể sử dụng phương thức boolean để lấy ra các giá trị này dưới dạng boolean. Phương thức boolean sẽ trả về true cho 1, "1", true, "true", "on" và "yes". Tất cả các giá trị khác sẽ trả về false:

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

Retrieving Array Input Values

Các giá trị input chứa mảng có thể được lấy ra bằng phương thức array. Phương thức này sẽ luôn cast giá trị input đó thành một mảng. Nếu request không chứa giá trị input với tên đã cho, một mảng trống sẽ được trả về:

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

Retrieving Date Input Values

Để thuận tiện, các giá trị input chứa ngày, giờ có thể được lấy ra dưới dạng instances Carbon bằng phương thức date. Nếu request không chứa các giá trị input có tên đã cho, null sẽ được trả về:

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

Tham số thứ hai và thứ ba được phương thức date chấp nhận là sử dụng để chỉ định định dạng và timezone của date tương ứng:

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

Nếu có giá trị input nhưng có định dạng không hợp lệ, lỗi InvalidArgumentException sẽ được đưa ra; do đó, bạn nên xác thực dữ liệu input trước khi gọi phương thức date.

Retrieving Interval Input Values

Các giá trị input chứa khoảng thời gian có thể được lấy ra dưới dạng các instance CarbonInterval bằng cách sử dụng phương thức interval. Nếu request không chứa giá trị input nào với tên đã cho, null sẽ được trả về:

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

Nếu giá trị input là số, bạn có thể cung cấp đơn vị làm tham số thứ hai. Đơn vị này có thể là một string như second, minute, hoặc day, hoặc một instance enum Carbon\Unit:

use Carbon\Unit;

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

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

Nếu giá trị input có tồn tại nhưng không phải định dạng hợp lệ, một exception InvalidArgumentException sẽ được đưa ra; do đó, bạn nên validate input trước khi gọi phương thức interval.

Retrieving Enum Input Values

Giá trị input tương ứng với PHP enums cũng có thể được lấy ra từ request. Nếu request không chứa giá trị input có tên đã cho hoặc enum không có giá trị nào khớp với giá trị input, null sẽ được trả về. Phương thức enum sẽ chấp nhận tên của giá trị input và class enum làm tham số thứ nhất và thứ hai của nó:

use App\Enums\Status;

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

Bạn cũng có thể cung cấp một giá trị mặc định sẽ được trả về nếu giá trị không có hoặc không hợp lệ:

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

Nếu giá trị input là một mảng các giá trị tương ứng với một PHP enum, bạn có thể sử dụng phương thức enums để lấy ra mảng các giá trị dưới dạng là các instance enum:

use App\Enums\Product;

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

Retrieving Input Via Dynamic Properties

Bạn cũng có thể truy cập vào thông tin input của người dùng bằng cách sử dụng các thuộc tính động trên instance Illuminate\Http\Request. Ví dụ: nếu một trong các form ứng dụng của bạn chứa field name, bạn có thể truy cập vào giá trị của field như sau:

$name = $request->name;

Khi sử dụng thuộc tính động, đầu tiên Laravel sẽ tìm giá trị của tham số trong payload của request. Nếu nó không tồn tại, Laravel sẽ tìm kiếm field đó trong các tham số của route.

Lấy A Portion Of The Input Data

Nếu bạn cần truy xuất một tập con của dữ liệu input, bạn có thể sử dụng các phương thức only hoặc except. Cả hai phương thức này đều chấp nhận một array hoặc một danh sách động các tham số:

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

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

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

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

[!WARNING] Phương thức only trả về tất cả các cặp key / value mà bạn yêu cầu; tuy nhiên, nó sẽ không trả về các cặp key / value mà không có trong request.

Kiểm tra Input

Bạn có thể sử dụng phương thức has để xác định xem giá trị đó có tồn tại trong request hay không. Phương thức has sẽ trả về true nếu giá trị tồn tại trong request:

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

Khi được cung cấp một mảng, phương thức has sẽ xác định xem tất cả các giá trị có trong mảng đó có tồn tại hay không:

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

Phương thức hasAny trả về true nếu có bất kỳ giá trị nào tồn tại:

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

Phương thức whenHas sẽ chạy closure đã cho nếu có một giá trị trong request tồn tại:

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

Closure thứ hai có thể được truyền cho phương thức whenHas và sẽ được chạy nếu giá trị được chỉ định không tồn tại trong request:

$request->whenHas('name', function (string $input) {
    // The "name" value is present...
}, function () {
    // The "name" value is not present...
});

Nếu bạn muốn xác định xem một giá trị có tồn tại trong request và không rỗng hay không, bạn có thể sử dụng phương thức filled:

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

Nếu bạn muốn xác định xem một giá trị có bị thiếu trong request hay không, hoặc là một chuỗi string rỗng, bạn có thể sử dụng phương thức isNotFilled:

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

Khi được cung cấp một mảng, phương thức isNotFilled sẽ xác định xem tất cả các giá trị có trong mảng đó có bị thiếu hoặc rỗng hay không:

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

Phương thức anyFilled sẽ trả về true nếu có giá trị nào đó được chỉ định không phải là chuỗi trống:

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

Phương thức whenFilled sẽ chạy closure đã cho nếu có một giá trị trong request và không rỗng:

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

Closure thứ hai có thể được truyền đến phương thức whenFilled sẽ được chạy nếu giá trị được chỉ định không có nội dung:

$request->whenFilled('name', function (string $input) {
    // The "name" value is filled...
}, function () {
    // The "name" value is not filled...
});

Để xác định xem một khóa nào đó có bị thiếu trong request hay không, bạn có thể sử dụng phương thức missing và phương thức whenMissing:

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

$request->whenMissing('name', function () {
    // The "name" value is missing...
}, function () {
    // The "name" value is present...
});

Merge thêm giá trị Input

Thỉnh thoảng, bạn có thể cần tự merge thêm dữ liệu input vào dữ liệu input hiện có của request. Để thực hiện điều này, bạn có thể sử dụng phương thức merge. Nếu khóa input đã tồn tại trong request, thì khóa này sẽ bị ghi đè bằng dữ liệu được cung cấp cho phương thức merge:

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

Phương thức mergeIfMissing có thể được sử dụng để merge input vào request nếu các khóa chưa tồn tại trong dữ liệu input của request:

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

Old Input

Laravel cho phép bạn giữ giá trị input từ request trước đó đến request tiếp theo. Tính năng này đặc biệt hữu ích cho việc điền lại các giá trị vào form sau khi phát hiện có lỗi dữ liệu. Tuy nhiên, nếu bạn đang sử dụng validation features của Laravel, có thể bạn sẽ không cần phải sử dụng trực tiếp phương thức flash vào session input theo cách thủ công, hệ thống built-in validation của Laravel sẽ tự động gọi đến chúng.

Flashing input đến Session

Phương thức flash trong class Illuminate\Http\Request sẽ flash tất cả input của request hiện tại vào session để những input đó được chuyển đến request tiếp theo của người dùng:

$request->flash();

Bạn cũng có thể sử dụng các phương thức flashOnly và flashExcept để flash một tập hợp con của dữ liệu request vào session. Các phương thức này rất hữu ích để giữ thông tin nhạy cảm không bị lưu vào session như mật khẩu:

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

$request->flashExcept('password');

Flashing Input vào chuyển hướng

Vì bạn thường xuyên phải flash input vào session và sau đó chuyển về trang trước đó, bạn có thể dễ dàng đưa những input đó vào chuyển hướng đó bằng cách sử dụng phương thức withInput:

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

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

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

Lấy Old Input

Để lấy một input flash từ request trước đó, hãy gọi phương thức old trong instance của Illuminate\Http\Request. Phương thức old sẽ lấy dữ liệu input được flash trước đó từ session:

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

Laravel cũng cung cấp một global helper old. Nếu bạn đang muốn hiển thị một old input vào trong một Blade template, nó sẽ thuận tiện hơn khi bạn sử dụng helper old để tạo lại form. Nếu old input không tồn tại, null sẽ được trả về:

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

Cookies

Lấy Cookies từ Request

Tất cả các cookie được tạo bởi Laravel framework đều được mã hóa và được ký bằng mã xác thực, nghĩa là chúng sẽ bị coi là không hợp lệ nếu chúng bị client thay đổi. Để lấy giá trị cookie từ request, hãy sử dụng phương thức cookie trong instance Illuminate\Http\Request:

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

Cắt và chuẩn hoá Input

Mặc định, Laravel sẽ chứa các middleware Illuminate\Foundation\Http\Middleware\TrimStrings và Illuminate\Foundation\Http\Middleware\ConvertEmptyStringsToNull trong stack middleware global của application. Các middleware này sẽ tự động trim tất cả các field dạng chuỗi trên request, cũng như chuyển đổi bất kỳ field nào đang ở dạng chuỗi trống thành null. Điều này cho phép bạn cần không phải lo lắng về những định dạng chuỗi có trong các route và controller của bạn.

Disabling Input Normalization

Nếu bạn muốn vô hiệu hóa hành vi này cho tất cả các request, bạn có thể xóa chúng ra khỏi stack middleware của application bằng cách gọi phương thức $middleware->remove trong file bootstrap/app.php của application của bạn:

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

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

Nếu bạn muốn disable tính năng cắt chuỗi và convert chuỗi rỗng cho một tập hợp các request đến ứng dụng của bạn, bạn có thể sử dụng các phương thức middleware trimStrings và convertEmptyStringsToNull trong file bootstrap/app.php của ứng dụng. Cả hai phương thức đều chấp nhận một mảng các closure, các closure này sẽ trả về true hoặc false để cho biết liệu việc chuẩn hóa input có nên được bỏ qua hay không:

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

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

Files

Lấy Uploaded Files

Bạn có thể ra các file đã được upload từ một instanceIlluminate\Http\Request bằng cách sử dụng phương thức file hoặc sử dụng các thuộc tính động. Phương thức file trả về một instance của class Illuminate\Http\UploadedFile, được extend từ class PHP SplFileInfo và cung cấp nhiều phương thức để tương tác với file:

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

$file = $request->photo;

Bạn có thể kiểm tra một file có tồn tại trong request hay không bằng cách sử dụng phương thức hasFile:

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

Kiểm tra upload thành công hay không

Ngoài việc kiểm tra xem file có tồn tại hay không, bạn cũng có thể cần xác minh rằng không có vấn đề gì khi tải file lên, qua phương thức isValid:

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

File Paths và Extensions

Class UploadedFile cũng chứa các phương thức có thể truy cập đến đường dẫn của file và phần đuôi mở rộng của nó. Phương thức extension sẽ cố gắng đoán phần đuôi mở rộng của file dựa trên nội dung của nó. Phần đuôi rộng này có thể khác với phần đuôi mở rộng được cung cấp bởi client:

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

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

Other File Methods

Có nhiều phương thức khác có sẵn trong các instance UploadedFile. Hãy kiểm tra tài liệu API cho class này để biết thêm thông tin về các phương thức này.

Lưu file upload

Để lưu trữ một file đã được tải lên, thông thường bạn sẽ sử dụng một trong các filesystems đã được cấu hình của bạn. Class UploadedFile có một phương thức store sẽ chuyển file đã tải lên vào một trong các disk của bạn, nó có thể là một vị trí trong local filesystem hoặc là một vị trí được lưu trữ trên đám mây như Amazon S3.

Phương thức store chấp nhận một đường dẫn, nơi mà file sẽ được lưu, và được bắt đầu tính từ đường dẫn gốc được cấu hình trong file filesystem. Đường dẫn này không được chứa tên file, vì một unique ID sẽ tự động được tạo để đặt tên file.

Phương thức store cũng chấp nhận một tham số thứ hai tùy chọn tên disk nào sẽ được sử dụng để lưu trữ file. Phương thức sẽ trả về đường dẫn của file liên kết đến thư mục gốc của disk đó:

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

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

Nếu bạn không muốn tên tệp được tự động tạo, bạn có thể sử dụng phương thức storeAs, nó sẽ chấp nhận một đường dẫn, một tên tệp và một tên disk làm tham số của nó:

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

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

[!NOTE] Để biết thêm thông tin về việc lưu file trong Laravel, hãy xem tài liệu về lưu file.

Cấu hình Trusted Proxies

Khi application của bạn đang chạy sau một hệ thống load balancer, mà không dùng chứng chỉ TLS / SSL để kết nối đến server của bạn. Đôi khi bạn sẽ cảm thấy rằng application của bạn sẽ không trả về liên kết HTTPS khi dùng helper url. Thông thường, điều này là do application của bạn đang bị chuyển tiếp lưu lượng truy cập từ load balancer vào cổng 80 và không biết rằng nó đang tạo ra các liên kết không an toàn.

Để giải quyết vấn đề này, bạn có thể enable middleware Illuminate\Http\Middleware\TrustProxies có trong application Laravel của bạn, cho phép bạn nhanh chóng tùy chỉnh các load balancer hoặc các proxy mà application đang sử dụng, mà bạn tin tưởng. Các proxy mà bạn tin tưởng nên được chỉ định bằng cách sử dụng phương thức middleware trustProxies trong file bootstrap/app.php của ứng dụng của bạn:

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

Ngoài việc cấu hình các proxy mà bạn tin tưởng, bạn cũng có thể cấu hình các header proxy mà bạn tin tưởng:

->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] Nếu bạn đang sử dụng AWS Elastic Load Balancing, thì giá trị $headers phải là Request::HEADER_X_FORWARDED_AWS_ELB. Nếu load balancer của bạn sử dụng chuẩn header Forwarded là RFC 7239, thì giá trị headers phải là Request::HEADER_FORWARDED. Để biết thêm thông tin về các hằng số có thể được sử dụng trong giá trị $headers này, hãy xem tài liệu của Symfony về trusting proxies.

Trusting tất cả Proxies

Nếu bạn đang sử dụng Amazon AWS hoặc các "cloud" khác cung cấp load balancer, bạn có thể không biết địa chỉ IP thật sự của load balancer. Trong trường hợp này, bạn có thể sử dụng * để trust tất cả các proxy:

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

Cấu hình Trusted Hosts

Mặc định, Laravel sẽ respond tất cả các request mà nó nhận được bất kể nội dung của header Host của request HTTP đó là gì. Ngoài ra, giá trị của header Host sẽ được sử dụng khi tạo URL cho ứng dụng của bạn trong khi web request.

Thông thường, bạn nên cấu hình máy chủ web của bạn, chẳng hạn như Nginx hoặc Apache, để chỉ gửi request đến ứng dụng giống với một hostname nhất định. Tuy nhiên, nếu bạn không có khả năng tùy chỉnh trực tiếp máy chủ web của bạn và cần hướng dẫn Laravel chỉ phản hồi với một số hostname nhất định, bạn có thể làm như vậy bằng cách bật middleware Illuminate\Http\Middleware\TrustHosts trong ứng dụng của bạn.

Để kích hoạt middleware TrustHosts, bạn nên gọi phương thức middleware trustHosts trong file bootstrap/app.php của ứng dụng của bạn. Sử dụng tham số at của phương thức này, bạn có thể chỉ định hostname mà ứng dụng của bạn sẽ phản hồi. Chuỗi hostname sẽ được xử lý như là một biểu thức chính quy. Các request đến với các header Host khác sẽ bị từ chối:

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

Mặc định, các request đến từ subdomain của URL ứng dụng cũng sẽ được tự động tin tưởng. Nếu bạn muốn tắt hành vi này, bạn có thể sử dụng tham số subdomains:

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

Nếu bạn cần truy cập vào các file cấu hình hoặc cơ sở dữ liệu của ứng dụng để xác định các host đáng tin cậy của bạn, bạn có thể cung cấp một closure cho tham số at:

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