میان افزار یا Middleware مانند یک لایه بین کاربر و درخواست است. یعنی وقتی کاربر به سرور درخواست ارسال میکند، آن درخواست ابتدا به میان افزار منتقل میشود. سپس میان افزار، بعد از بررسی صحت درخواست ها، آن ها را تایید و یا رد میکند. اگر درخواست کاربر صحت داشته باشد، به backend ارسال میشود. در صورت رد درخواست کاربر، میان افزار کاربر را به صفحه ورود (Login) هدایت خواهد کرد.

از یک Middleware یا میان افزار فرعی می توان برای انجام کارهای مختلف، به جز احراز هویت استفاده کرد. به عنوان مثال میان افزار CORS مسئول افزودن سرصفحه به تمام پاسخ هاست.

فریمورک لاراول شامل چندین Middleware مثل authentication (احراز هویت) و محافظت CSRF است. این میان افزارها در دایرکتوری app/Http/Middleware قرار دارند.

بطور کلی می توان گفت که Middleware یک فیلتر درخواست از نوع http است که به کمک آن میتوانید شرایط و وضعیت را بررسی کنید.

ایجاد یک میان افزار در لاراول

ابتدا وارد محیط ترمینال سیستم خود شوید و مانند تصویر زیر دستور ‘php artisan make:middleware ‘name of the middleware را وارد کنید.

در تصویر بالا، دستور “php artisan make:middleware CheckAge” در یک Middleware به نام CheckAge وارد شده است.

این دستور یک کلاس جدید با نام CheckAge در دایرکتوری app/Http/Middleware ایجاد کرده است.

همانطور که میبینید یک میان افزار به نام “CheckAge” با موفقیت ایجاد شده است.

اجرای یک میان افزار در لاراول

میتوان مشخص کرد که یک Middleware، در تمام URL ها یا برخی از URL های خاص اجرا شود.

در این مثال ابتدا یک Middleware برای تمام URL ها اجرا میکنیم.

گام اول: فایل kernel.php را باز کنید. سپس path یا مسیر میان افزار موردنظر را در آرایه middleware اضافه کنید.

1. <?php
3. namespace App\Http;
5. use Illuminate\Foundation\Http\Kernel as HttpKernel;
7. class Kernel extends HttpKernel
9. {
11. /**
13. * The application’s global HTTP middleware stack.
15. *
17. * These middleware are run during every request to your application.
19. *
21. * @var array
23. */
25. protected $middleware = [ \Illuminate\Foundation\Http\Middleware\CheckForMaintenanceMode::class,
27. \Illuminate\Foundation\Http \Middleware\ValidatePostSize::class,
29. \App\Http\Middleware\TrimStrings::class,
31. \App\Http\Middleware\CheckAge
33. ::class,
35. \Illuminate\Foundation\Http\Middleware\ConvertEmptyStringsToNull::class,
37. ];
41. /**
43. * The application’s route middleware groups.
45. *
47. * @var array
49. */
53. protected $middlewareGroups = [
55. ‘web’ => [
57. \App\Http\Middleware\EncryptCookies::class,
61. \Illuminate\Cookie\Middleware\AddQueuedCookiesToResponse::class,
65. \Illuminate\Session\Middleware\StartSession::class,
69. // \Illuminate\Session\Middleware\AuthenticateSession::class,
71. \Illuminate\View\Middleware
73. \ShareErrorsFromSession::class,
77. \App\Http\Middleware\VerifyCsrfToken::class,
81. \Illuminate\Routing\Middleware\SubstituteBindings::class,
83. ],
87. ‘api’ => [
89. ‘throttle:60,1’,
91. ‘bindings’,
93. ],
95. ];
101. /**
103. * The application’s route middleware.
105. *
107. * These middleware may be assigned to groups or used individually.
109. *
111. *
113. @var array
115. */
117. protected $routeMiddleware = [
121. ‘auth’ => \Illuminate\Auth\Middleware\Authenticate::class,
123. ‘auth.basic’ => \Illuminate\Auth\Middleware
125. \AuthenticateWithBasicAuth::class,
129. ‘bindings’ => \Illuminate\Routing\Middleware\SubstituteBindings::class,
133. ‘can’ => \Illuminate\Auth\Middleware\Authorize::class,
135. ‘guest’ => \App\Http\Middleware
137. \RedirectIfAuthenticated::class,
141. ‘throttle’ => \Illuminate\Routing\Middleware\ThrottleRequests::class,
143. ];
145. }

گام دوم: دستور php artisan serve را در پنجره Git Bash وارد کنید.

گام سوم: فایل CheckAge.php که به عنوان یک Middleware ایجاد کرده اید را باز کنید.

1. <?php
3. namespace App\Http\Middleware;
5. use Closure;
7. class CheckAge
9. {
11. /**
12. * Handle an incoming request.
13. *
14. * @param \Illuminate\Http
15. \Request $request
16. * @param \Closure $next
17. * @return mixed
18. */
19. public function handle($request, Closure $next)
20. {
21. //return “middleware”;
22. echo “hello world”;
23. return $next($request);
24. }
25. }

قدم چهارم: در آخر در قسمت URL مرورگر خود، آدرس ‘http://localhost/laravelproject/public/‘ را وارد کنید. خروجی شما مانند تصویر زیر خواهد بود.

اکنون در این مثال یک Middleware برای برخی از مسیرهای خاص اجرا میکنیم.

گام اول: فایل kernel.php را باز کنید.

1. <?php
2. namespace App\Http;
3. use Illuminate\Foundation\Http\Kernel as HttpKernel;
4. class Kernel extends HttpKernel
5. {
6. /**
7. * The application’s global HTTP middleware stack.
8. *
9. * These middleware are run during every request to your application.
10. *
11. * @var array
12. */
13. protected $middleware = [
14. \Illuminate\Foundation\Http\Middleware\CheckForMaintenanceMode::class,
15. \Illuminate\Foundation\Http\Middleware\ValidatePostSize::class,
16. \App\Http\Middleware\TrimStrings::class,
21. \Illuminate\Foundation\Http\Middleware\ConvertEmptyStringsToNull::class,
22. ];
23. /**
24. * The application’s route middleware groups.
25. *
26. * @var array
27. */
28. protected $middlewareGroups = [
29. ‘web’ => [
30. \App\Http\Middleware\EncryptCookies::class,
31. \Illuminate\Cookie\Middleware\AddQueuedCookiesToResponse::class,
32. \Illuminate\Session\Middleware\StartSession::class,
33. // \Illuminate\Session\Middleware\AuthenticateSession::class,
34. \Illuminate\View\Middleware \ShareErrorsFromSession::class,
35. \App\Http\Middleware\VerifyCsrfToken::class,
36. \Illuminate\Routing\Middleware\SubstituteBindings::class,
37. ],
39. ‘api’ => [
40. ‘throttle:60,1’,
41. ‘bindings’,
42. ],
43. ];
44. /**
45. * The application’s route middleware.
46. *
47. * These middleware may be assigned to groups or used individually.
48. *
49. *
50. @var array
51. */
52. protected $routeMiddleware = [
54. ‘auth’ => \Illuminate\Auth\Middleware\Authenticate::class,
55. ‘auth.basic’ => \Illuminate\Auth\Middleware
56. \AuthenticateWithBasicAuth::class,
58. ‘bindings’ => \Illuminate\Routing\Middleware\SubstituteBindings::class,
60. ‘can’ => \Illuminate\Auth\Middleware\Authorize::class,
61. ‘guest’ => \App\Http\Middleware
62. \RedirectIfAuthenticated::class,
64. ‘throttle’ => \Illuminate\Routing\Middleware\ThrottleRequests::class,
66. ‘age’ => \App\Http\Middleware\CheckAge::class ];
68. }

در قطعه کد  .i.e بالا یعنی

age’ => \App\Http\Middleware\CheckAge::class’

را در یک Middleware که نام آن age است، اضافه کرده ایم.

گام دوم: فایل CheckAge.php را که به عنوان یک میان افزار ایجاد کردید را باز کنید.

گام سوم: کد middleware زیر را در فایل web.php وارد کنید.

1. Route::Get(‘/’,function()
2. {
3. return view(‘welcome’);
4. })-> middleware(‘age’);
5. Route::Get(‘user/profile’,function()
6. {
7. return “user profile”;
8. });

توجه داشته باشید که در کد بالا ما middleware را به آدرس root ‘/’ اضافه کرده ایم نه به آدرس ‘user/profile’ .

زمانی که به root URL دسترسی داریم، خروجی به صورت زیر خواهد بود:

خروجی بالا نشان دهنده این است که کد middleware در حال نمایش “hello world” است.

زمانی که به URL, i.e., /user/profile دسترسی داریم، خروجی به صورت زیر خواهد بود:

خروجی بالا به این معنی است که امکان دسترسی به کد middleware وجود ندارد.

زمانی که پارامتر به یک URL منتقل می شود:

web.php

1. Route::Get(‘/{age}’,function($age)
2. {
3. return view(‘welcome’);
4. })-> middleware(‘age’);

CheckAge.php

1. <?php
2. namespace App\Http\Middleware;
3. use Closure;
4. class CheckAge
5. {
6. /**
7. * Handle an incoming request.
8. *
10. * @param
11. \Illuminate\Http\Request $request
12. * @param \Closure $next
13. * @return mixed
14. */
15. public function handle($request, Closure $next)
16. {
17. //return “middleware”;
18. echo “this is checkage middleware”;
19. return $next($request);
20. }}

خروجی:

بررسی وضعیت در میان افزار

میتوان از Middleware ها برای بررسی وضعیت لاراول نیز استفاده کرد. به کدها و خروجی مثال زیر دقت کنید:

1. Route::Get(‘/{age}’,function($age)
2. {
3. return view(‘welcome’);
4. })-> middleware(‘age’);

————————————————————————————————————————————

1. <?php
2. namespace App\Http\Middleware;
3. use Closure;
4. class CheckAge
5. {
7. /**
8. * Handle an incoming request.
9. *
11. * @param
12. \Illuminate\Http\Request $request
14. * @param \Closure $next
15. * @return mixed
16. */
18. public function handle($request, Closure $next)
20. {
21. //return “middleware”;
22. if($request->age>10)
23. {
24. echo “Age is greater than 10”;
25. }
26. else
27. {
28. echo”Age is not greater than 10″;
29. }
30. return $next($request);
32. }}

خروجی هر دوی آنها به صورت زیر خواهد بود :