Tạo Middleware trong Laravel đơn giản trong 5 phút

Middleware trong Laravel là một tầng trung gian giữa yêu cầu HTTP của người dùng và xử lý của controller. Nó cho phép bạn thực hiện các tác vụ như xác thực, kiểm tra quyền truy cập, chuyển hướng, hay chèn các thông tin vào request.

Trong bài này tôi sẽ giới thiệu cho các bạn về Middleware ,cách tạo một middleware hoản chỉnh và cách sử dụng Middleware trong laravel nhé !

1. Middleware là gì ?

Middleware là một trung gian trong quá trình xử lý các yêu cầu HTTP trong Laravel. Nó là một lớp hoặc một tập hợp các lớp, được sử dụng để xác thực, kiểm tra quyền hoặc chặn hoặc cho phép một yêu cầu HTTP đến một controller hoặc route. Middleware có thể thực hiện các tác vụ như lọc dữ liệu trước khi đưa đến controller, hoặc chặn hoặc cho phép yêu cầu dựa trên một điều kiện nhất định.

Ví dụ, một middleware có thể được sử dụng để kiểm tra xem người dùng đã đăng nhập hay chưa trước khi cho phép truy cập vào một trang cần quyền truy cập. Nếu người dùng chưa đăng nhập, middleware sẽ chặn yêu cầu và chuyển hướng người dùng đến trang đăng nhập.

Bài viết này được đăng tại [free tuts .net]

Tạo và sử dụng middleware trong Laravel rất đơn giản với các lệnh Artisan. Bạn có thể tạo mới một middleware bằng lệnh

php artisan make:middleware MiddlewareName

và sau đó liên kết nó với một hoặc nhiều route hoặc controller bằng cách sử dụng phương thức 'middleware' trong Laravel.

2. Cách tạo một middleware trong Laravel

Sử dụng lệnh Artisan

Lệnh Artisan là một công cụ dòng lệnh trong Laravel, cho phép bạn tạo các task, migrations, models, controllers và các cấu trúc khác một cách nhanh chóng và dễ dàng. Các lệnh Artisan có sẵn trong Laravel giúp bạn giải quyết các tác vụ thông dụng mà không cần phải viết code từ đầu.

Vài ví dụ về các lệnh Artisan thông dụng:

* Tạo controller:

php artisan make:controller ControllerName

* Tạo model:

php artisan make:model ModelName

* Tạo migration:

php artisan make:migration create_table_name

* Migrate database:

php artisan migrate

* Rollback migration:

php artisan migrate:rollback

* Xem các lệnh Artisan:

php artisan list

* Xem thông tin chi tiết về một lệnh:

php artisan help [command name]

Sau khi chạy lệnh trên, Laravel sẽ tạo một file mới tên 'ControllerName.php' trong thư mục 'app/Http/Controllers'. File này sẽ chứa một class có tên UserController, và sẽ có một số phương thức cơ bản như 'index', 'create', 'store', 'show', 'edit, 'update' và 'destroy'. Bạn có thể thêm hoặc chỉnh sửa các phương thức để phù hợp với nhu cầu của dự án.

Tạo từ scratch

Tạo một ứng dụng Laravel mới từ đầu (scratch) có thể làm bằng cách sử dụng lệnh composer trên dòng lệnh. Bạn có thể tạo một dự án mới bằng cách chạy lệnh sau:

composer create-project --prefer-dist laravel/laravel project-name

Trong đó, 'project-name' là tên của dự án mới bạn muốn tạo. Sau khi chạy lệnh, Composer sẽ tải về và cài đặt tất cả các thư viện và tập tin cần thiết cho Laravel và tạo một dự án mới cho bạn.

Ví dụ: Tạo một dự án Laravel mới tên là "myapp"

composer create-project --prefer-dist laravel/laravel myapp

Sau khi tạo dự án, bạn có thể di chuyển đến thư mục dự án và chạy máy chủ tạm thời bằng cách chạy lệnh sau:

php artisan serve

Bạn có thể truy cập vào dự án của mình tại địa chỉ http://localhost:8000 trên trình duyệt.

3.Cách sử dụng Middleware trong laravel

Tạo một Middleware

* Mở terminal và chạy lệnh sau để tạo một Middleware mới

php artisan make:middleware <TênMiddleware>

Ví dụ:

php artisan make:middleware CheckAge\

* Sau khi chạy lệnh trên, Laravel sẽ tạo một file mới trong thư mục 'app/Http/Middleware'. Mở file đó và chỉnh sửa logic của Middleware theo nhu cầu của bạn.

* Để sử dụng Middleware, bạn cần đăng ký nó với ứng dụng Laravel. Bạn có thể đăng ký Middleware ở file 'app/Http/Kernel.php'. Thêm middleware của bạn vào mảng '$routeMiddleware'.

Ví dụ:

protected $routeMiddleware = [
    'checkage' => \App\Http\Middleware\CheckAge::class,
];

* Cuối cùng, bạn có thể áp dụng Middleware vào một Route hoặc một nhóm Route bằng cách sử dụng phương thức 'middleware' của đối tượng Route.

Ví dụ:

Route::get('/admin', function () {
    // logic của Route
})->middleware('checkage');

Trong ví dụ trên, Middleware 'CheckAge' sẽ được áp dụng vào Route '/admin'.

Cấu hình Middleware

Để cấu hình Middleware trong Laravel, bạn có thể sử dụng các phương thức và thuộc tính trong file Middleware của bạn.

Một số phương thức và thuộc tính quan trọng trong Middleware:

1.Phương thức handle($request, Closure $next):

Trong Laravel,'handle()' là một phương thức trong Middleware được gọi khi một yêu cầu HTTP đang đi qua middleware này. Nó nhận hai tham số: '$request' (đối tượng yêu cầu HTTP) và '$next' (closure chứa logics cho phần tiếp theo của pipeline).

Phương thức 'handle()' có nhiệm vụ kiểm tra và xử lý yêu cầu HTTP trước khi đưa nó đến phần tiếp theo của pipeline. Ví dụ, nó có thể kiểm tra xem người dùng có được phép truy cập vào trang yêu cầu hay không, hoặc chuyển hướng người dùng đến trang đăng nhập nếu họ chưa đăng nhập.

Sau khi xử lý, phương thức handle() sẽ gọi $next để cho phép phần tiếp theo của pipeline được thực hiện. Nếu phương thức handle() không gọi $next, yêu cầu sẽ bị dừng lại và không được chuyển đến phần tiếp theo của pipeline.

Ví dụ, dưới đây là một ví dụ về Middleware cơ bản:

namespace App\Http\Middleware;

use Closure;

class ExampleMiddleware
{
    public function handle($request, Closure $next)
    {
        if ($request->input('age') < 18) {
            return redirect('home');
        }

        return $next($request);
    }
}

Trong ví dụ này, Middleware sẽ kiểm tra xem giá trị của tham số "age" trong yêu cầu có nhỏ hơn 18 hay không. Nếu nhỏ hơn 18, nó sẽ chuyển hướng người dùng đến trang "home". Nếu không, nó sẽ gọi $next để cho phép yêu cầu được chuyển đến phần tiếp theo của pipeline.

=> handle() là một phương thức rất quan trọng trong Middleware vì nó cung cấp một cách để kiểm tra và xử lý yêu cầu trước khi nó được chuyển đến phần tiếp theo của pipeline.

2.Thuộc tính $except:

- Thuộc tính $except trong Middleware cung cấp một cách để xác định những URL mà Middleware sẽ không áp dụng. Điều này có thể hữu ích khi bạn muốn Middleware chỉ áp dụng cho một số trang cụ thể và bỏ qua các trang khác.

Ví dụ, dưới đây là một ví dụ về việc sử dụng thuộc tính $except:

namespace App\Http\Middleware;

use Closure;

class ExampleMiddleware
{
    protected $except = [
        'home',
        'about'
    ];

    public function handle($request, Closure $next)
    {
        if (in_array($request->route()->uri, $this->except)) {
            return $next($request);
        }

        // Các logics cho phần xử lý của Middleware...

        return $next($request);
    }
}

Trong ví dụ này, thuộc tính $except chứa một mảng các URL mà Middleware sẽ bỏ qua. Phương thức handle sẽ kiểm tra xem URL của yêu cầu có nằm trong mảng '$except' hay không. Nếu có, nó sẽ trả về '$next($request)' mà không thực hiện bất kỳ xử lý nào khác. Nếu không, nó sẽ thực hiện các logics xử lý cho Middleware và sau đó trả về $next($request) để cho phép yêu cầu được chuyển đến phần tiếp theo của pipeline.

Phương thức terminate($request, $response)

- Phương thức terminate trong Middleware được gọi sau khi một yêu cầu được xử lý và trả về một đối tượng response. Điều này cho phép bạn thực hiện một số thao tác cuối cùng trên yêu cầu hoặc trả về trước khi nó được gửi đến người dùng.

Ví dụ, dưới đây là một ví dụ về việc sử dụng phương thức terminate:

namespace App\Http\Middleware;

use Closure;

class ExampleMiddleware
{
    public function handle($request, Closure $next)
    {
        $response = $next($request);

        return $response;
    }

    public function terminate($request, $response)
    {
        // Các logics xử lý cuối cùng...
    }
}

Trong ví dụ này, phương thức handle đơn giản chỉ gọi '$next($request)' và trả về '$response'. Sau đó, phương thức terminate được gọi với hai tham số là $request và $response, cho phép bạn thực hiện một số xử lý cuối cùng trên yêu cầu hoặc trả về.

=>, phương thức terminate là một tính năng rất hữu ích trong Laravel Middleware, cho phép bạn thực hiện một số thao tác cuối cùng trên yêu cầu hoặc trả về trước khi nó được gửi đến người dùng.

Lưu ý rằng bạn cũng có thể sử dụng Middleware để xác thực người dùng, kiểm tra quyền truy cập và thực hiện các thao tác khác với Request và Response của bạn.

Đăng ký Middleware

Để đăng ký Middleware trong Laravel, bạn có thể thêm Middleware vào mảng '$middleware' hoặc '$routeMiddleware' trong file 'app/Http/Kernel.php' như sau:

Đối với Middleware toàn cục, thêm Middleware vào mảng '$middleware'. Ví dụ, để đăng ký Middleware có tên là' MyMiddleware', bạn có thể thêm dòng sau vào mảng '$middleware':

protected $middleware = [
    // Các Middleware toàn cục khác
    \App\Http\Middleware\MyMiddleware::class,
];

Ví dụ, để đăng ký Middleware có tên là 'MyMiddleware' và đường dẫn đến file Middleware là 'app/Http/Middleware/MyMiddleware.php', bạn có thể thêm dòng sau vào mảng '$routeMiddleware':

protected $routeMiddleware = [
    // Các Middleware được sử dụng trong các Route cụ thể
    'MyMiddleware' => \App\Http\Middleware\MyMiddleware::class,
];

Sau khi đăng ký Middleware, bạn có thể sử dụng chúng trong các Route bằng cách gọi tên Middleware tương ứng. Ví dụ, để sử dụng Middleware MyMiddleware trong một Route, bạn có thể sử dụng phương thức middleware như sau:

Route::get('/example', function () {
    // Logic của Route
})->middleware('MyMiddleware');

Sử dụng Middleware trong Route

Đầu tiên, bạn cần đăng ký Middleware trong file 'app/Http/Kernel.php' bằng cách thêm nó vào mảng '$middleware' hoặc $'routeMiddleware'.

Sau đó, bạn có thể sử dụng Middleware trong một Route bằng cách sử dụng phương thức middleware khi định nghĩa Route. Ví dụ, để sử dụng Middleware có tên là 'MyMiddleware' trong một Route, bạn có thể sử dụng như sau:

Route::get('/example', function () {
    // Logic của Route
})->middleware('MyMiddleware');

Nếu bạn muốn sử dụng nhiều Middleware cho một Route, bạn có thể truyền một mảng các tên Middleware vào phương thức middleware. Ví dụ, để sử dụng hai Middleware là MyMiddleware và AnotherMiddleware trong một Route, bạn có thể sử dụng như sau:

Route::get('/example', function () {
    // Logic của Route
})->middleware(['MyMiddleware', 'AnotherMiddleware']);

Lưu ý rằng thứ tự các Middleware được sử dụng sẽ quan trọng. Middleware được khai báo trước sẽ được thực hiện trước. Nếu có các Middleware trùng tên được sử dụng cho một Route, Laravel sẽ sử dụng Middleware được đăng ký đầu tiên.

4. Thực hành tạo Middleware trong Laravel

Để triển khai Middleware tuỳ chỉnh trong Laravel ngay lập tức, hãy kích hoạt một lệnh và thiết lập tất cả. Tiếp theo, chúng ta cần viết logic cho chức năng cụ thể và xác định chức năng đó trong ứng dụng của mình. Được rồi, vậy hãy đi sâu vào nó với một số ví dụ.

Bước 1 : Tạo project trong Laravel

Trước tiên mở CMD của bạn chạy lệnh sau

composer create-project laravel/laravel LaravelMiddleware --prefer-dist

Truy cập phpMyAdmin và tạo 1 cơ sở dữ liệu đặt tên là Middleware laravel hoặc bạn có thể đặt tên khác nếu bạn muốn .

Sau đó chuyển sang trình chỉnh sửa của bạn , '.env file' và đặt thông tin của cơ sở dữ liệu bạn vừa tạo vào đó

Bước 2 : Admin trong Middleware trong Laravel

Để kiểm tra bạn có phải admin không thì một lần nữa hãy đi tới file , di chuyển đến bảng người dùng của bạn và thêm một file 'isAdmin' dữ liệu của nó là 'boolean'

<?php 

// create_users_migrations 

  public function up() 
    { 
        Schema::create('users', function (Blueprint $table) { 
            $table->increments('id'); 
            $table->string('name'); 
            $table->string('email'); 
            $table->string('password'); 
            $table->boolean('isAdmin')->nullable(); 
            $table->rememberToken(); 
            $table-> dấu thời gian(); 
        }); 
    }

Sau đó chạy lệnh

php artisan migrate 

Bước tiếp theo tạo chức năng xác thực do Laravel cung cấp và nhập nội dung vào terminal

php artisan make:auth

Khỏi động máy chủ bằng nội dung sau

php artisan serve

Giờ hãy tạo ba người dùng và truy cập URL sau :http://localhost:8000/register

Hãy nhớ rằng chúng cho pháp chỉ định bất kì người dùng nào làm Admin bằng cách thử công ,nhưng trong ứng dụng web bạn cần cung cấp một số giao diện để trao quyền quản trị

Bước 3: Tạo một Middleware Laravel cơ bản

Tạo một Middleware bằng cách nhập lệnh

php artisan make:middleware Admin

điều hướng đến folder sau . app >> Http >> Middleware >> Admin.php

Tới đay bạn có một hàm để sử lý là handle()

// Middleware Admin.php

  /**
     * xử lý hàm được gửi dến .
     *
     * @param  \Illuminate\Http\Request  $request
     * @param  \Closure  $next
     * @return mixed
     */
    public function handle($request, Closure $next)
    {
        return $next($request);
    }

Chúng ta cần viết logic trong chức năng này để lọc request và nếu nó thỏa mãn, hãy chuyển đến trang đích; nếu không, hãy quay lại đăng nhập hoặc bất kỳ trang chuyển hướng nào bạn sẽ cung cấp.

 /**  Admin.php
     * Handle an incoming request.
     *
     * @param  \Illuminate\Http\Request  $request
     * @param  \Closure  $next
     * @return mixed
     */
    public function handle($request, Closure $next)
    {
      if(auth()->user()->isAdmin == 1){
        return $next($request);
      }
        return redirect('home')->with('error','You have not admin access');
    }

Bạn cần đăng ý trong route app >> Http >> Kernel.php

+ Bạn có thể đăng ký làm global middleware

+Bạn có thể đăng ký như route cụ thể được gọi là route middleware.

Khi đã làm đủ 2 bước trên thì chuyển đến protected $routeMiddleware property

<?php

// Kernel.php

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,
        'admin' => \App\Http\Middleware\Admin::class,
    ];

như bạn thấy Middleware đã có tên là Admin

Bước 4 : Admin protected route middleware.

Tạo một route có tên 'protectedAdmin' nếu nguopiwf dùng không phải quản trị , nó sẽ điều hướng tới Home page

<?php 

// web.php 

Route::get('admin/routes', 'HomeController@admin')->middleware('admin');

Máy đặt liên kết lên khi người dùng đăng nhập

<!-- home.blade.php -->

@extends('layouts.app')

@section('content')
<div class="container">
  @if(\Session::has('error'))
    <div class="alert alert-danger">
      {{\Session::get('error')}}
    </div>
  @endif
    <div class="row">
        <div class="col-md-8 col-md-offset-2">
            <div class="panel panel-default">
                <div class="panel-heading">Dashboard</div>

                <div class="panel-body">
                    <a href="{{url('admin/routes')}}">Admin</a>
                </div>
            </div>
        </div>
    </div>
</div>
@endsection

tất cả những gì ta cần là viết mã chức năng admin nằm trong HomeController

<?php

// HomeController.php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

class HomeController extends Controller
{
    
    /**
     * Show the application dashboard.
     *
     * @return \Illuminate\Http\Response
     */
    public function index()
    {
        return view('home');
    }

    public function admin()
    {
        return view('admin');
    }

}

Bước 5 : Tạo một file Blade

<!-- admin.blade.php -->

<!DOCTYPE html>
<html>
  <head>
    <meta charset="utf-8">
    <title>ADMIN PAGE</title>
  </head>
  <body>
    WELCOME TO ADMIN ROUTE
  </body>
</html>

Bây giờ truy cập đăng nhập bằng trường IsAdmin 1 cách bình thường .

Tổng kết

Middleware là một trong những tính năng quan trọng trong Laravel .

Bạn có thể sử dụng Middleware để thực hiện nhiều tác vụ khác nhau, như xác thực người dùng, chặn truy cập theo IP, ghi lại lịch sử truy cập, v.v.

Cấu trúc của Middleware gồm hai phần chính: phương thức 'handle 'và phương thức 'terminate'. Phương thức handle được gọi khi một yêu cầu đến, cho phép bạn kiểm soát và xử lý yêu cầu trước khi nó được gửi đến các xử lý chính của ứng dụng. Phương thức 'terminate' được gọi sau khi một yêu cầu được xử lý và trả về một đối tượng response, cho phép bạn thực hiện một số xử lý cuối cùng trên yêu cầu hoặc trả về.

Tổng quan, Middleware là một tính năng rất hữu ích trong Laravel, cho phép bạn kiểm soát và xử lý các yêu cầu HTTP một cách dễ dàng và linh hoạt. Nếu bạn đang sử dụng Laravel, hãy tìm hiểu

về Middleware và cách sử dụng nó để giải quyết các vấn đề trong ứng dụng của bạn. Bạn cũng có thể tạo ra các Middleware riêng cho mục đích cụ thể của mình hoặc sử dụng các Middleware đã có sẵn trong thư viện Laravel.

Cuối cùng, hãy nhớ rằng Middleware chỉ là một trong nhiều tính năng mạnh mẽ của Laravel, và sử dụng chúng cùng với các tính năng khác, như Route, Controller, v.v., sẽ giúp bạn xây dựng các ứng dụng mạnh mẽ và dễ dàng quản lý.