미들웨어는 애플리케이션에 들어오는 HTTP 요청을 검사하고 필터링하기 위한 편리한 메커니즘을 제공합니다. 예를 들어 Lithe에는 사용자가 인증되었는지 확인하는 미들웨어가 포함되어 있습니다. 그렇지 않은 경우 미들웨어는 사용자를 로그인 화면으로 리디렉션합니다. 사용자가 인증되면 미들웨어는 요청 진행을 허용합니다.

미들웨어가 Lithe에서 작동하는 방식

Lithe에서 미들웨어는 애플리케이션의 요청-응답 주기에서 요청 개체($req), 응답 개체($res) 및 $next 함수에 액세스하는 기능입니다. $next 함수가 호출되면 현재 스택의 다음 미들웨어를 호출합니다.

미들웨어 기능은 애플리케이션에 들어오는 HTTP 요청을 검사, 필터링 및 조작하는 편리한 방법을 제공합니다. 다음을 수행할 수 있습니다.

• 모든 코드를 실행합니다.
• 요청 및 응답 개체를 수정합니다.
• 요청-응답 주기를 종료합니다.
• 스택에서 다음 미들웨어를 호출합니다.

현재 미들웨어가 요청-응답 주기를 종료하지 않으면 $next()를 호출하여 다음 미들웨어에 제어권을 전달해야 합니다. 그렇지 않으면 요청이 보류 상태로 유지됩니다.

미들웨어 기능의 요소

다음 코드는 미들웨어 기능의 요소를 보여줍니다.

$app->use(function ($req, $res, $next) {
    $next();
});

어디:

• $req: 일반적으로 $req라고 불리는 HTTP 요청 인수입니다.
• $res: 일반적으로 $res라고 불리는 HTTP 응답 인수입니다.
• $next: 일반적으로 $next라고 불리는 콜백 인수입니다.

미들웨어 정의

다음은 myLogger라는 미들웨어의 간단한 예입니다. 이 미들웨어는 요청이 통과할 때마다 LOGGED 메시지를 인쇄합니다. myLogger:
라는 변수에 할당된 함수로 정의됩니다.

$myLogger = function ($req, $res, $next) {
  echo 'LOGGED';
  $next();
};

위의 $next() 호출을 확인하세요. 이 함수는 애플리케이션에서 다음 미들웨어를 호출합니다. $next()는 내장된 PHP 또는 Lithe 함수가 아니지만 미들웨어 함수에 전달되는 세 번째 인수입니다. $next()의 이름은 무엇이든 지정할 수 있지만 관례상 항상 "next"라고 합니다. 혼란을 피하려면 이 규칙을 따르세요.

미들웨어를 HTTP 요청이 애플리케이션에 도달하기 전에 통과하는 일련의 "계층"으로 상상해 보세요. 각 레이어는 요청을 검사하거나 거부할 수 있습니다.

미들웨어 로딩

미들웨어를 로드하려면 \Lithe\App 클래스의 use() 메서드를 호출하여 미들웨어 기능을 지정합니다. 예를 들어:

$app = new \Lithe\App;

$myLogger = function ($req, $res, $next) {
    echo 'LOGGED';
    $next();
};

$app->use($myLogger);

$app->get('/', function ($req, $res, $next) {
    $res->send('Hello World!');
});

앱이 요청을 받을 때마다 "LOGGED"라는 메시지가 인쇄됩니다. 미들웨어 로딩 순서가 중요합니다. 먼저 로드된 미들웨어가 먼저 실행됩니다.

myLogger 미들웨어는 단순히 메시지를 인쇄한 후 $next()를 사용하여 요청을 다음 미들웨어로 전달합니다.

미들웨어 사용

Lithe 애플리케이션은 다음 유형의 미들웨어를 사용할 수 있습니다.

• 애플리케이션 수준 미들웨어
• 라우터 수준 미들웨어
• 타사 미들웨어

애플리케이션 수준 미들웨어

use() 또는 METHOD() 메서드를 사용하여 애플리케이션 수준 미들웨어를 애플리케이션 인스턴스에 연결합니다. 여기서 METHOD는 소문자의 HTTP 메서드(예: GET, PUT, POST)를 나타냅니다.

이 예는 경로가 없는 미들웨어를 보여줍니다. 미들웨어는 요청이 수신될 때마다 실행됩니다.

$app->use(function ($req, $res, $next) {
    echo 'Hello World!';
    $next();
});

아래 예에서 미들웨어는 /user/:id:
경로에 대한 GET 요청을 처리합니다.

$app->get('/user/:id', function ($req, $res, $next) {
    if ($req->param('id') === '0') {
        return $next();
    } 
    $res->send('ID is not 0');
}, function ($req, $res) {
    $res->send('regular');
});

라우터 수준 미들웨어

라우터 수준 미들웨어는 애플리케이션 수준 미들웨어처럼 작동하지만 \Lithe\Http\Router:
인스턴스에 연결됩니다.

$router = new \Lithe\Http\Router;

use() 및 METHOD() 함수를 사용하여 라우터 수준 미들웨어를 로드합니다.

다음은 라우터 수준 미들웨어의 예입니다.

$router = new \Lithe\Http\Router;

$router->use(function ($req, $res, $next) {
    echo 'Time: ', Date('H:i:s'), '
';
    $next();
});

$router->get('/user/:id', function ($req, $res, $next) {
    if ($req->param('id') === '0') {
        $res->redirect('/');
    }
    $next();
}, function ($req, $res) {
    echo $req->param('id');
    $res->render('special');
});

$app->use('/api', $router);

타사 미들웨어

타사 미들웨어를 사용하여 Lithe 애플리케이션에 기능을 추가할 수 있습니다. 필요한 PHP 모듈을 설치한 다음 애플리케이션 또는 라우터 수준에서 로드합니다.

다음은 \Lithe\Middleware\Session\session:
을 사용하여 세션 미들웨어를 로드하는 예입니다.

use function Lithe\Middleware\Session\session;

$app = new \Lithe\App;

$app->use(session([
    'secure' => true
]));

Lithe와 함께 일반적으로 사용되는 타사 미들웨어 목록은 타사 미들웨어 리소스를 확인하세요.

구성 가능한 미들웨어

미들웨어를 구성 가능하게 해야 하는 경우 옵션 배열이나 기타 매개변수를 허용한 다음 해당 매개변수를 기반으로 미들웨어 구현을 반환하는 함수를 만들 수 있습니다. 아래 예를 참조하세요.

이제 사용자 정의 구성으로 미들웨어를 사용할 수 있습니다.



$app->use(my_middleware(['option1' => '1', 'option2' => '2']));




다른 개발자가 Composer를 통해 설치할 수 있는 미들웨어를 만들기 위해 lithemod/flow라는 패키지가 있습니다. Lithe에서 HTTP 요청 및 응답을 처리하기 위한 인터페이스와 유틸리티를 제공하여 다양한 애플리케이션 전반에 걸쳐 표준화되고 즉시 사용 가능한 미들웨어 생성을 용이하게 합니다.

lithemod/flow는 요청 및 응답을 위한 통합 인터페이스를 제공하여 강력한 미들웨어를 구축하여 개발을 더욱 효율적이고 체계적으로 만듭니다. 이는 미들웨어를 다른 프로젝트에 통합하는 것을 단순화하고 코드가 일관된 표준을 따르도록 보장합니다.