Laravel 미들웨어의 기본 사항을 마스터하세요

이 글에서는 미들웨어의 개념을 이해하기 위해 Laravel 프레임워크에 대해 자세히 살펴보겠습니다. 이 기사의 전반부는 미들웨어와 미들웨어의 실제 용도에 대한 소개로 시작됩니다.

계속 진행하면서 Laravel 애플리케이션에서 사용자 정의 미들웨어를 생성하는 방법을 다룰 것입니다. 사용자 정의 미들웨어를 생성한 후에는 요청 처리 흐름 중에 실제로 호출할 수 있도록 Laravel에 등록하는 데 사용할 수 있는 옵션을 살펴보겠습니다.

기본 Laravel 개념과 스캐폴딩 코드 생성을 위한 Artisan 명령줄 도구에 대해 잘 알고 계시기를 바랍니다. 물론, 최신 Laravel 애플리케이션을 설치하면 이 기사에 제공된 예제를 즉시 실행할 수 있습니다.

Laravel의 미들웨어란 무엇인가요?

미들웨어는 Laravel 애플리케이션의 일반적인 요청 처리 흐름에 연결할 수 있는 메커니즘으로 생각할 수 있습니다. 일반적인 Laravel 경로 처리는 요청 처리의 특정 단계를 거치며, 미들웨어는 애플리케이션이 반드시 통과해야 하는 계층 중 하나입니다.

그렇다면 Laravel의 요청 처리 프로세스를 연결하는 요점은 무엇입니까? 애플리케이션 부팅 초기 단계에서 수행해야 할 작업에 대해 생각해 보세요. 예를 들어 사용자는 현재 경로에 액세스할 수 있는지 여부를 결정하기 위해 초기에 인증을 받아야 합니다.

미들웨어로 달성할 수 있다고 생각되는 몇 가지 사항은 다음과 같습니다.

• 녹화요청
• 사용자 리디렉션
• 수신 매개변수 변경/청소
• Laravel 애플리케이션에서 생성된 응답을 조작하세요
• 더 많은 것

사실 기본 Laravel 애플리케이션에는 이미 몇 가지 중요한 미들웨어가 함께 제공됩니다. 예를 들어 사이트가 유지 관리 모드인지 확인하는 미들웨어가 있습니다. 반면에 입력 요청 매개변수를 삭제하는 미들웨어도 있습니다. 앞서 언급했듯이 사용자 인증 역시 미들웨어 자체를 통해서 구현됩니다.

지금까지의 설명이 미들웨어라는 용어에 대해 좀 더 자신감을 갖는 데 도움이 되었기를 바랍니다. 여전히 혼란스럽다면 걱정하지 마세요. 다음 섹션에서 사용자 정의 미들웨어 구축을 시작할 것이므로 실제 세계에서 미들웨어를 사용하는 방법을 정확히 이해하는 데 도움이 될 것입니다.

맞춤형 미들웨어를 만드는 방법

이 섹션에서는 맞춤형 미들웨어를 만들어 보겠습니다. 하지만 우리의 맞춤형 미들웨어는 정확히 무엇을 달성해야 할까요?

최근에 사용자가 모바일 장치에서 웹사이트에 액세스하는 경우 모든 쿼리 문자열 매개변수를 변경하지 않은 채 해당 하위 도메인 URL로 리디렉션해야 한다는 클라이언트의 사용자 지정 요구 사항을 발견했습니다. 저는 이것이 이 특정 시나리오에서 Laravel 미들웨어를 사용하는 방법을 보여주는 완벽한 사용 사례라고 믿습니다.

이 경우 미들웨어를 사용하려는 이유는 애플리케이션의 요청 흐름에 연결해야 하기 때문입니다. 맞춤형 미들웨어에서는 사용자 에이전트를 확인하고 사용자가 모바일 장치를 사용 중인 경우 해당 모바일 URL로 리디렉션됩니다.

이론을 모두 논의한 후 실제 개발을 시작하면 이것이 새로운 개념을 이해하는 가장 좋은 방법이지 않습니까?

Laravel 개발자로서 사용자 정의 기능을 생성하려는 경우 대부분의 경우 Artisan 도구를 사용하여 기본 템플릿 코드를 생성하게 됩니다. 이를 사용하여 사용자 정의 미들웨어에 대한 기본 템플릿 코드를 생성해 보겠습니다.

명령줄로 이동하여 프로젝트의 문서 루트로 이동하세요. 다음 명령을 실행하여 사용자 정의 미들웨어 템플릿 MobileRedirect을 생성하세요.

으아악

다음 코드를 사용하여 파일 app/Http/Middleware/MobileRedirect.php을 생성해야 합니다.

으아악

미들웨어의 백본 역할을 하고 구현하려는 미들웨어의 기본 로직이 위치해야 하는 handle메서드의 구현을 일반적으로 알 수 있습니다.

이번 기회에 Laravel과 함께 제공되는 미들웨어 유형을 소개해보세요. 프론트 미들웨어와 포스트 미들웨어의 두 가지 주요 유형이 있습니다.

이름에서 알 수 있듯이 비포 미들웨어는 요청이 실제로 처리되고 응답이 구성되기 전에 실행되는 미들웨어입니다. 반면, 포스트 미들웨어는 애플리케이션이 요청을 처리한 후에 실행되며 이때 응답은 이미 구성되었습니다.

우리의 경우 요청을 처리하기 전에 사용자를 리디렉션해야 하므로 사전 미들웨어로 개발됩니다.

다음 내용으로 파일을 수정하세요

. app/Http/Middleware/MobileRedirect.php 으아악

단순화를 위해

만 확인하면 사용자는 모바일 장치의 해당 사이트 URL로 리디렉션됩니다. 물론 실시간 탐지를 원한다면 사용자 에이전트 탐지 라이브러리를 사용하는 것이 좋습니다. mobile 查询字符串参数是否存在，如果将其设置为 TRUE

또한

경로는 데모용 자리 표시자이므로 올바른 경로나 URL로 바꾸는 것이 좋습니다. mobile-site-url-goes-here

按照我们的自定义逻辑，调用 $next($request) 允许在应用程序链中进一步处理请求。在我们的例子中需要注意的重要一点是，我们将移动检测逻辑放置在 $next($request) 调用之前，有效地使其成为一个 before 中间件。

这样，我们的自定义中间件就几乎准备好进行测试了。目前，Laravel 无法了解我们的中间件。为此，您需要向 Laravel 应用程序注册您的中间件，这正是我们下一节的主题。

在进入下一部分之前，我想演示一下后中间件的外观，以防万一有人对此感到好奇。

<?php
 
namespace App\Http\Middleware;
 
use Closure;
 
class CustomMiddleWare
{
    /**
     * Handle an incoming request.
     *
     * @param  \Illuminate\Http\Request  $request
     * @param  \Closure  $next
     * @return mixed
     */
    public function handle($request, Closure $next)
    {
        $response = $next($request);
        
        /* your custom logic goes here */
        
        return $response;
    }
}

正如您已经注意到的，中间件的自定义逻辑在 Laravel 应用程序处理请求后执行。此时，您还可以访问 $response 对象，如果您愿意，它允许您操作它的某些方面。

这就是 after 中间件的故事。

我们的自定义中间件正在运行

本节描述了向 Laravel 应用程序注册中间件的过程，以便在请求处理流程中实际调用它。

继续打开文件 app/Http/Kernel.php 并查找以下代码片段。

/**
 * The application's global HTTP middleware stack.
 *
 * These middleware are run during every request to your application.
 *
 * @var array
 */
protected $middleware = [
    \Illuminate\Foundation\Http\Middleware\CheckForMaintenanceMode::class,
    \Illuminate\Foundation\Http\Middleware\ValidatePostSize::class,
    \App\Http\Middleware\TrimStrings::class,
    \Illuminate\Foundation\Http\Middleware\ConvertEmptyStringsToNull::class,
];

如您所见，$middleware 保存了 Laravel 默认安装附带的中间件数组。此处列出的中间件将根据每个 Laravel 请求执行，因此它是放置我们自己的自定义中间件的理想选择。

继续添加我们的自定义中间件，如以下代码片段所示。

protected $middleware = [
    \Illuminate\Foundation\Http\Middleware\CheckForMaintenanceMode::class,
    \Illuminate\Foundation\Http\Middleware\ValidatePostSize::class,
    \App\Http\Middleware\TrimStrings::class,
    \Illuminate\Foundation\Http\Middleware\ConvertEmptyStringsToNull::class,
    \App\Http\Middleware\MobileRedirect::class,
];

现在，尝试使用查询字符串 mobile=1 访问任何 Laravel 路由，这应该会触发我们的中间件代码！

这就是您应该注册需要在每个请求上运行的中间件的方式。但是，有时您希望仅针对特定路由运行中间件。让我们检查一下如何使用 $routeMiddleware 来实现这一点。

在我们当前示例的上下文中，我们假设如果用户访问您网站上的任何特定路由，他们将被重定向到移动网站。在这种情况下，您不想将中间件包含在 $middleware 列表中。

相反，您希望将中间件直接附加到路由定义，如下所示。

Route::get('/hello-world', 'HelloWorldController@index')->middleware(\App\Http\Middleware\MobileRedirect::class);

事实上，我们可以更进一步，为我们的中间件创建一个别名，这样您就不必使用内联类名。

打开文件 app/Http/Kernel.php 并查找 $routeMiddleware ，它保存了别名到中间件的映射。让我们将我们的条目包含到该列表中，如以下代码片段所示。

protected $routeMiddleware = [
    'auth' => \Illuminate\Auth\Middleware\Authenticate::class,
    'auth.basic' => \Illuminate\Auth\Middleware\AuthenticateWithBasicAuth::class,
    'bindings' => \Illuminate\Routing\Middleware\SubstituteBindings::class,
    'can' => \Illuminate\Auth\Middleware\Authorize::class,
    'guest' => \App\Http\Middleware\RedirectIfAuthenticated::class,
    'throttle' => \Illuminate\Routing\Middleware\ThrottleRequests::class,
    'mobile.redirect' => \App\Http\Middleware\MobileRedirect::class
];

修改后的路由定义如下所示。

Route::get('/hello-world', 'HelloWorldController@index')->middleware('mobile.redirect');

这就是向 Laravel 应用程序注册中间件的故事。这非常简单，不是吗？

事实上，我们已经读到了本文的结尾，我希望您能充分享受它。

结论

探索任何框架中的架构概念总是令人兴奋的事情，这就是我们在本文中探索 Laravel 框架中的中间件时所做的事情。

从中间件的基本介绍开始，我们将注意力转移到在 Laravel 应用程序中创建自定义中间件的主题。文章的后半部分讨论了如何向 Laravel 注册自定义中间件，这也是探索附加中间件的不同方式的机会。

希望这次旅程富有成效，并且本文能够帮助您丰富您的知识。另外，如果您希望我在即将发表的文章中提出特定主题，您可以随时给我留言。

今天就这样，如果有任何疑问，请随时使用下面的提要来提出您的疑问！

위 내용은 Laravel 미들웨어의 기본 사항을 마스터하세요의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!